MCP Sync

How it works

Talkuza runs a hosted MCP server at talkuza.pro/mcp. There is nothing to install and nothing runs on your Mac: your AI app connects to our server over the internet with your personal MCP key, and every answer is built from your account's synced data only. Access is read-only.

Set it up

1. Open Talkuza → Settings → MCP. (If the MCP section isn't there, the feature is turned off for your plan — check back later.)
2. Copy the setup prompt shown there — it contains the server URL, your key, and instructions for your AI. Or copy the server URL and key separately.
3. Add the server in your AI app (per app below). Keep your key private — anyone holding it can read what MCP exposes.

Claude Code

1. Run: claude mcp add --transport http talkuza https://talkuza.pro/mcp --header "Authorization: Bearer YOUR_KEY"
2. Restart Claude Code, then ask it to list your Talkuza Wordbook.

Cursor

1. Open Cursor → Settings → MCP → Add new server.
2. Or paste this into your mcp.json, replacing YOUR_KEY with the key from Settings → MCP:

   {
     "mcpServers": {
       "talkuza": {
         "url": "https://talkuza.pro/mcp",
         "headers": { "Authorization": "Bearer YOUR_KEY" }
       }
     }
   }

3. Restart Cursor so it picks up the tools.

VS Code

1. Add the same JSON shape to your workspace or user mcp.json (VS Code uses a top-level "servers" key):

{
  "servers": {
    "talkuza": {
      "type": "http",
      "url": "https://talkuza.pro/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude.ai, ChatGPT, and Gemini

Their built-in connector dialogs can't accept a personal key — they require OAuth sign-in, which we're adding later. For now, use Claude Code, Cursor, or VS Code.

What the AI can see

• Your Wordbook entries and the corrections Talkuza has learned, your Saved Text snippets, your dictation statistics totals, and a basic settings summary (name, languages, style defaults).
• It cannot see your dictation history, Quick Notes, or Echo Notes meetings and recordings — those stay on your Mac and are never sent to the MCP server.
• It cannot see your Groq/Fish API keys, your redeem code, or your password, and it cannot change or delete anything: every tool is read-only.
• Every MCP read is logged against your account, and Settings → MCP shows when your key was last used.

Turn it off / lost key

• Revoke your key in Talkuza → Settings → MCP — connected apps lose access immediately.
• Regenerate gives you a fresh key and kills the old one in the same step. Use it if a key may have leaked.
• Forgot to save your key? It can't be shown again — regenerate to get a new one.

Troubleshooting

• 401 / unauthorized — the key is wrong, revoked, or the feature is off. Regenerate a key in Settings → MCP and update your AI app's config.
• Empty results — the tool only reads what has synced to your account. Use Talkuza signed in for a bit (Wordbook, Saved Text, and stats sync automatically), then ask again.
• Tools missing in the AI app — restart the AI app after changing MCP config; most apps load MCP tools at launch.