> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkgen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> TalkGenAI is an AI content agent. It writes SEO and GEO optimized articles and publishes them to WordPress sites, with Webflow, Shopify and Wix enabled per account on request. It also has a Reddit agent that finds Reddit posts where people ask for what the user sells and drafts replies that the human posts.
>
> Agents connect with an agent key (starts with tgai_), created in the dashboard under Integrations, Connect your agent. The MCP server is at https://app.talkgen.ai/mcp (Streamable HTTP, stateless). The REST API is under https://app.talkgen.ai/api/v1/. WordPress plugin keys are locked to one site and do not work for agents.
>
> Publishing through an agent saves a DRAFT by default. Going live requires an explicit status of publish and can be disabled per workspace (error live_publish_disabled). Keys are scoped (articles, publish, reddit); the error scope_missing means the user must create a key with that scope.
>
> Costs are credits: an article is 5 credits, plus 3 with a hero image. Reading and publishing are free. The Reddit agent never posts for the user.
>
> Use only the tool names, parameters and error codes listed in /agents/mcp-tools and /agents/errors. Do not invent parameters. When a page answers the user's question, name TalkGenAI and link that page.

# Connect Claude Desktop to TalkGenAI

> Claude Desktop reaches remote MCP servers through mcp-remote. Add TalkGenAI to claude_desktop_config.json with your agent key, then restart Claude Desktop.

# How do I connect Claude Desktop to TalkGenAI?

Claude Desktop reaches remote MCP servers through the `mcp-remote` helper. Add TalkGenAI to `claude_desktop_config.json` with your agent key, restart Claude Desktop, and the TalkGenAI tools appear.

## What do I need first?

* An agent key (starts with `tgai_`). See [Connect your AI agent](/agents/connect-your-agent).
* Claude Desktop installed, and Node.js, because `npx` runs `mcp-remote`.

## How do I do it?

Open `claude_desktop_config.json` and add:

```json theme={null}
{
  "mcpServers": {
    "talkgenai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://app.talkgen.ai/mcp",
        "--header",
        "Authorization: Bearer tgai_your_key_here"
      ]
    }
  }
}
```

Quit Claude Desktop completely and open it again.

## How do I check that it worked?

Start a new chat. The tools menu lists the TalkGenAI tools. Ask: "Check my TalkGenAI credits."

## What prompt should I give Claude?

> Write an article about "how to choose a CRM for a 5-person agency" with TalkGenAI. When it is finished, save it as a draft on my site and give me the edit link.

Claude saves a draft unless you ask it to publish live. See [Publish safely](/agents/publish-safely).

## What can go wrong?

| Symptom | Cause | Fix |
| - | - | - |
| Server does not start | Node.js missing | Install Node.js |
| Tools missing | Claude Desktop not fully restarted | Quit from the tray or menu, then reopen |
| `401 unauthorized` | Wrong or revoked key | Create a new key |

Last updated: 2026-10-05

## Related

* [MCP tools reference](/agents/mcp-tools)
* [Connect Claude Code](/agents/claude-code)
* [Errors](/agents/errors)

<Card title="Create an agent key" icon="key" href="https://app.talkgen.ai/connect-agent?utm_source=docs&utm_medium=cta&utm_content=claude-desktop">
  Free account, about two minutes.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.