Kamaankamaan
Sign inStart free trial
← All docs
Guide

Run your blog from a chat

Kamaan ships an MCP server, so you can connect it to your favorite AI client and manage your content by just talking. It works with Claude, ChatGPT, Cursor, and any other MCP-compatible client — it's not Claude-only. Once connected, you write, edit, translate, and publish articles from a normal conversation, no app-switching, no copy-paste.

What you can do

Once connected, you can just ask, in plain language, things like:

  • “List my sites and show me the latest 10 posts on the Acme blog.”
  • “Write a 1,000-word post about headless CMS pricing for the Acme blog, then publish it.”
  • “Translate that article into Spanish, German, and French.”
  • “Find my post about onboarding and tighten its meta description for SEO.”

The AI picks the right Kamaan tool for each request, you never type a function name.

Before you start

  • A Kamaan plan with API access, and at least one site.
  • An MCP-capable client: Claude (web or Desktop), Perplexity, ChatGPT (connector or a custom GPT), Cursor, or any MCP client.
  • A Kamaan API key (we'll create one in step 1).

Connect in 3 steps

1
Create a Kamaan API key

In Kamaan, go to Settings → API & MCP and create a key. It looks like sk_live_… and is shown only once, copy it somewhere safe.

2
Add Kamaan as a connector

The connection details are the same everywhere, only where you paste them differs:

  • Server URL: https://kamaan.io/mcp
  • Auth: Bearer token, your sk_live_… key

Claude web (claude.ai)

Go to claude.ai/customize/connectors and click + Add custom connector (or open the add-connector dialog directly). Then:

  • Name: Kamaan
  • Remote MCP server URL: https://kamaan.io/mcp
  • Leave the OAuth fields under Advanced settings blank, then click Add.

No key needed here: Claude web signs you in directly. It opens a Kamaan sign-in page, you enter your email and the one-time code we send you (or it skips that if you're already signed in to Kamaan in this browser), you approve the connection, and you're in. On Team/Enterprise, your workspace owner adds it once and each member signs in individually.

Claude Desktop

In the desktop app, open Settings → Developer → Edit Config and add Kamaan to your mcpServers, then restart Claude. Paste your sk_live_… key in place of the placeholder:

{
  "mcpServers": {
    "kamaan": {
      "url": "https://kamaan.io/mcp",
      "headers": { "Authorization": "Bearer sk_live_your_key_here" }
    }
  }
}

Perplexity

Go to Settings → Connectors → Add custom connector. Then:

  • Give it a Name (e.g. Kamaan).
  • MCP server URL: https://kamaan.io/mcp
  • Click Advanced, set Authentication to API Key, and paste your Kamaan sk_live_… key.
  • Click Add.

Prefer no key? Under Advanced you can instead leave Authentication as OAuth (no Client ID/Secret needed): Perplexity opens the Kamaan sign-in page and you authorize it there. Either way works.

ChatGPT

ChatGPT has two paths, depending on your plan. Most people will use Option B (a custom GPT).

Option A — ChatGPT connector (Pro/Business, MCP)

If your ChatGPT plan offers custom connectors, turn on Settings → Connectors → Advanced → Developer mode, then Create a new connector. Set the server URL to https://kamaan.io/mcp, choose Bearer / access-token auth, and paste your sk_live_… key. Start a new chat and enable the Kamaan connector for it.

Option B — Build your own Kamaan GPT (any paid ChatGPT plan)

Create a custom GPT that talks to Kamaan with your own API key. This uses Kamaan's REST “Actions” (read your sites and articles, write, edit, and translate). You need a paid ChatGPT plan to create custom GPTs.

  1. In ChatGPT, open Explore GPTs → + Create, then the Configure tab.
  2. Scroll to Actions and click Create new action.
  3. Under Schema, click Import from URL and paste: https://kamaan.io/openapi/kamaan-actions-schema.json (or paste the JSON directly).
  4. Set Authentication to API Key, Auth Type: Bearer, and paste your Kamaan sk_live_… key.
  5. Save the action, give your GPT a name and instructions (e.g. “You help me manage my Kamaan blog”), and Create it.

Make a fresh key in Settings → API & MCP first; new keys include write access so your GPT can create and translate articles, not just read. Keep the GPT private to you, since it carries your key.

Cursor

Open Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json) with the same shape as the Claude config above: the https://kamaan.io/mcp URL and an Authorization: Bearer sk_live_… header.

Any other MCP client, or just the API

Any MCP-compatible client connects the same way: custom server URL https://kamaan.io/mcp plus your key as a Bearer token. If you would rather call Kamaan directly instead of through an assistant, use the REST API, see the API reference.

3
Start talking to it

Open a new chat and try: “Using Kamaan, list my sites.” The client will call Kamaan, authenticate with your key, and return your sites. From there, ask it to write, translate, or publish.

What the AI can do for you

Kamaan exposes these capabilities to the connected client:

My_Sites          – list your sites
Site_Details      – full config for one site
Browse_Articles   – list a site's articles (filter by language/status)
Read_Article      – read one article in full
Search_Articles   – search by title / focus keyword
Write_Article     – create a new article (markdown)
Edit_Article      – update an existing article
Update_SEO_Fields – update SEO / meta only
Translate_Article – translate into one or more languages

Troubleshooting

“Unauthorized” / connection refused: double-check the server URL is exactly https://kamaan.io/mcp and that your key is passed as a Bearer token. If in doubt, generate a fresh key in Settings → API & MCP and update your client.

“Limit reached” (429):you've used your plan's monthly call allowance. It resets next billing period; see Settings → Billing for usage, or upgrade for more.

The client can't see the tools: make sure the connector is enabled/toggled on in your client and that you started a new conversation after adding it.

Privacy & security

  • Your key only grants access to your own Kamaan content, nothing else.
  • Revoke or rotate keys anytime from Settings → API & MCP.
  • All traffic between your client and Kamaan is encrypted over HTTPS.

Looking for the raw REST API instead (to render your blog on your own site)? See the API reference.