attentionfactory
All guides
TRANSCRIPTX®Setup guide

Setup · Claude Desktop & claude.ai

Get any video's transcript directly inside Claude

Add TranscriptX as a custom connector. It takes about a minute, works in both Claude Desktop and claude.ai, and the connector syncs across both when you're signed in to the same account.

Generate token

Easy way · Custom connectors UI

  1. Open Claude. In the left sidebar, click Customize.
  2. Open the Connectors tab.
  3. Click the + button at the top of the connectors list.
  4. Choose Add custom connector.
  5. Paste your URL:
    https://transcriptx.xyz/mcp/?token=YOUR_TOKEN
  6. Save. Claude connects, and the TranscriptX tools show up in your next chat.

Replace YOUR_TOKEN with the personal token from your /account/mcp page. The token lives in the URL, so there's no separate auth header to add.

Power-user way · JSON config (Claude Desktop)

If you'd rather edit the config file directly, open:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this to the mcpServers block:

{
  "mcpServers": {
    "transcriptx": {
      "url": "https://transcriptx.xyz/mcp/?token=YOUR_TOKEN"
    }
  }
}

Restart Claude Desktop. Same result as the Connectors UI.

What you can do once it's connected

Six tools become available to your AI:

  • transcribe_urltranscribe any public video or audio URL (1 credit)
  • watch_urlactually watch a video: frames, a timestamped transcript, and engagement numbers (2 credits)
  • list_creator_videoslist recent videos from a YouTube, TikTok, IG, or Spotify profile (1 credit per 5)
  • retry_transcript_languagere-run a previous transcript with a forced language (free)
  • list_recent_transcriptsyour recent transcript history (free)
  • get_account_statusyour plan and remaining credits (free)

Try it

Make Claude watch the video

watch_url hands Claude the actual frames plus a timestamped transcript and the real view, like, and comment counts. That's how it can tell you what's happening on screen, not only what was said. Tap any prompt to copy it.

Watching costs 2 credits per video. A plain transcript is 1.

Or just get the words

If something breaks

  • Connector won't save, or "invalid URL". Make sure the URL has /mcp/ before ?token=.
  • Tools don't show up. Start a new chat. If they're still missing, fully quit and relaunch Claude.
  • "Connection refused" or 401. The token is wrong, expired, or revoked. Generate a new one at /account/mcp.