# Slate for Claude: the Slate MCP server

> Slate is a screen recorder. Its MCP server lets Claude, Cursor, VS Code or any MCP client read your recordings: transcripts, which page was on screen at each moment, screenshots, comments and tags, and lets it tag, comment, rename and upload as you. A Team plan feature.

- Server URL: `https://api.slatevideo.com/mcp` (Streamable HTTP)
- Sign-in: OAuth 2.1 with PKCE and dynamic client registration, discovered from the server URL. Metadata: https://api.slatevideo.com/.well-known/oauth-authorization-server and https://api.slatevideo.com/.well-known/oauth-protected-resource/mcp
- Or a team API key (`slk_…`) as `Authorization: Bearer`
- Human version of this page: https://slatevideo.com/claude

## How it works

Pull, not push. Slate sends nothing anywhere on its own: no webhooks, no sync. Each time you ask, the client calls one of Slate's tools and gets back only what the signed-in account (or the team key) could already open on the web. It cannot delete recordings, change who can see them, share them, or touch billing or your team.

## What it is for

- **Bug reports, read for you.** Paste the link to a recording of something breaking. Claude reads what was said, sees which page was open at each moment, takes screenshots where it goes wrong and writes up the ticket.
- **Catch up without watching.** Ask what a walkthrough covered, what a teammate decided, or what the comments asked for. Answers come with the moment in the recording, so you can jump to it.
- **Keep the library in order.** Have Claude tag recordings, give them clearer titles and summaries, answer comments and resolve the ones it has dealt with.
- **Hand Slate a file.** Give Claude a video file, and a .vtt transcript if you have one, and it uploads it to your library, where it gets a transcript, a title and a summary like anything you recorded.

Things to ask:

- "Here is a bug report: <link>. Find where it fails, screenshot that moment and draft a Jira ticket."
- "What did the recordings tagged "onboarding" this week decide? Quote the moments."
- "Read the comments on <link> and tell me which ones still need an answer."
- "Tag every recording about the billing page with "billing"."

## Connect

### Claude.ai and Claude Desktop

1. **Add the connector.** Claude.ai or Claude Desktop: Settings, then Connectors, then Add custom connector. Name it Slate and paste the server URL. On a Team or Enterprise plan, an owner adds it once for everyone.
2. **Choose Connect.** Claude opens Slate in a new window.
3. **Sign in to Slate.** With Google or your email. Already signed in, and this step goes by on its own.
4. **Approve.** Slate shows which app is asking and what it will be able to do. Choose Allow, and you are back in Claude with Slate connected.

Server URL: `https://api.slatevideo.com/mcp`

### Claude Code

Then run /mcp inside Claude Code to sign in.

```bash
claude mcp add --transport http slate https://api.slatevideo.com/mcp
```

### Cursor

In `.cursor/mcp.json`:

```json
{ "mcpServers": { "slate": { "url": "https://api.slatevideo.com/mcp" } } }
```

### VS Code

In `.vscode/mcp.json`:

```json
{ "servers": { "slate": { "type": "http", "url": "https://api.slatevideo.com/mcp" } } }
```

### Anything else

Any client that speaks Streamable HTTP connects to the same URL and signs in the same way.

Connecting needs a seat on a Slate Team plan. Without one, the server answers `402 plan_required` and the client is pointed at pricing.

## Team API keys (bots, CI, shared agents)

Signing in connects as a person. A team API key connects as the team: no browser, nobody's account.

1. **Make a key.** A team admin or owner opens Settings, then API keys, names the key, picks what it may do and, if it should run out, when.
2. **Copy it once.** The key starts slk_ and is shown that one time. Slate keeps only a hash of it.
3. **Hand it to the bot.** Send it as a bearer token to the same server URL. No browser, no sign-in.

Make one at https://slatevideo.com/settings/api-keys (team admins and owners).

```bash
claude mcp add --transport http slate https://api.slatevideo.com/mcp \
  --header "Authorization: Bearer slk_..."
```

| Scope | Allows |
| --- | --- |
| `videos:read` | Every read tool. Always included: a key that may tag has to be able to find what it is tagging. |
| `tags:write` | add_tag and remove_tag, with the team’s existing tags. |
| `comments:write` | add_comment, posted under the key’s name as “<name> (API key)”. |

- A key reads what a team admin reads in the team’s library: recordings shared with the team or wider. Never one kept private or shared only with named people, never another team’s.
- It manages nothing: no uploads, renames, resolving comments or viewer lists.
- Up to 10 live keys a team. A key lasts until revoked unless you set an expiry.
- Revoking one in Settings cuts it off on its next call. Each call is logged against the key.
- It works on the MCP server only, and only while the team’s plan is live.

## Tools

| Tool | What it does | Changes | API key |
| --- | --- | --- | --- |
| `get_me` | The signed-in person (or the key’s team), their teams and plan. | Reads | Any key |
| `find_videos` | Search your library and your team’s by words in the title, summary or transcript, by tag or by date. | Reads | videos:read |
| `get_video` | Title, summary, tags, the pages that were on screen and when each came up, and counts. | Reads | videos:read |
| `get_transcript` | What was said, as timestamped lines. Narrow it to a stretch, or to the lines that mention something. | Reads | videos:read |
| `get_activity` | Which app, window and web page had focus at each moment (Mac app recordings). | Reads | videos:read |
| `get_screenshot` | A still frame as an image, a run of them, or a spread across a stretch. Up to 8 a call. | Reads | videos:read |
| `get_comments` | The thread, the moment each comment is pinned to, and whether it is resolved. | Reads | videos:read |
| `get_reactions` | Emoji reactions and their moments. | Reads | videos:read |
| `get_viewers` | Who watched and how far they got. Owners and team admins only. | Reads | People only |
| `list_tags` | The tags you can use, personal and team. | Reads | videos:read |
| `add_comment` | Comment as you, optionally pinned to a moment. The owner is notified as usual. | Writes | comments:write |
| `resolve_comment` | Resolve or reopen a comment. Owner, team admin or the comment’s author. | Writes | People only |
| `add_tag` | Add a tag by name or id, creating it if your team allows. | Writes | tags:write |
| `remove_tag` | Take a tag off. The tag itself stays. | Writes | tags:write |
| `update_video` | Change a title or summary. Owner or team admin only. | Writes | People only |
| `upload_video` | Start a new recording from a video or audio file (up to 5 GB), with an optional title, summary and .vtt transcript. Returns the upload URL and the curl command that sends the file. | Writes | People only |
| `finish_upload` | Close the upload so the recording processes: transcript, title and summary, like anything recorded. | Writes | People only |

"People only" tools are there when signed in as a person, never for a team key.

## Pointing at a recording

- **Any link works.** A share link on any domain (…/v/abc123), the share id out of one, the library id, or an /edit/ link. Custom domains included.
- **One clock.** Every moment is seconds on the finished recording, after cuts and stitched clips, and can be written as 83, "1:23" or "1m23s". The transcript, activity, comments, reactions and screenshots all share it.
- **Not found means not yours.** A recording the account could not open on the web is “not found” here too. The same rules decide both.

## Your data

- Claude signs in with OAuth 2.1 and PKCE on Slate’s own consent page. Slate never sees your Claude password, and Claude never sees your Slate one.
- We keep a hash of each token, never the token, and a record of which tool was called and whether it worked. Not your questions, and not what the tools returned.
- Nothing Claude reads through Slate is used for advertising or to train AI models.

To disconnect, choose Disconnect next to the client under Claude and other AI tools in Settings (https://slatevideo.com/settings), or remove the connector in the client. A team key stops when an admin revokes it.

Privacy policy for AI tools: https://slatevideo.com/privacy#ai-tools

Support: support@slatevideo.com, answered within two business days.
