MCP-Server

Start

1. Persönlichen Token erstellen

   Öffne Einstellungen → Integrationen, wechsle zu Konto-Integrationen und erstelle einen Token im MCP-Bereich. Er wird nur einmal angezeigt. Du kannst bis zu 10 aktive Tokens behalten.

2. Client auf den www-Host zeigen

   Füg das Snippet für deinen Client unten ein. Ersetze YOUR_TOKEN_HERE. Die öffentlichen Analyse-Tools funktionieren auch ohne Token.

Cursor

Füg das in ~/.cursor/mcp.json ein, oder in .cursor/mcp.json eines Projekts. Cursor liest url plus headers für einen Remote-HTTP-Server.

{
  "mcpServers": {
    "gehirn": {
      "url": "https://www.gehirn.md/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Code

Registriere den Server in der Shell. --header sendet den Bearer-Token. Prüfe ihn mit claude mcp list.

claude mcp add --transport http gehirn https://www.gehirn.md/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

VS Code

VS Code nutzt ein servers-Objekt auf der obersten Ebene, nicht mcpServers. Leg das in .vscode/mcp.json oder in dein Benutzer-mcp.json.

{
  "servers": {
    "gehirn": {
      "type": "http",
      "url": "https://www.gehirn.md/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json startet lokale Befehle. Es hat kein url-Feld für Remote-Server. Diese Config startet mcp-remote und legt den Bearer-Token in env, weil ein Leerzeichen in args auf manchen Desktops verfälscht wird.

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

{
  "mcpServers": {
    "gehirn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.gehirn.md/api/mcp",
        "--header",
        "Authorization:${GEHIRN_TOKEN}"
      ],
      "env": {
        "GEHIRN_TOKEN": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Starte Claude Desktop nach dem Speichern neu. Einstellungen → Connectors → Add custom connector kann auf dieselbe URL zeigen, nimmt aber keinen Bearer-Token an. Konto-Tools bleiben dort unerreichbar.

Tools

Zweiundzwanzig Tools. Konto-Tools brauchen einen Tarif in der Testphase oder einen aktiven Tarif. Artikel-Credits und die übrigen Kontingente des Tarifs gelten weiter. Es gibt kein eigenes Planungs-Tool: Content-Pläne entstehen über start_write.

Fragen und Entwurfsprüfung

1. start_research oder start_write liefert einen Job. Läuft er noch, frag get_job ab.
2. Wenn der Job Eingaben braucht, enthält get_job die Fragen. Zeig sie der Person und schick die Antworten mit answer_job.
3. Wenn ein Entwurf dabei ist, zeig den vollständigen Entwurf, bevor du um Freigabe bittest. Freigeben oder eine Überarbeitung anfordern verbraucht keinen weiteren Artikel-Credit.

Sicherheit

• Ein Token kann alle Konto-Tools dieses Kontos nutzen. Er liest kein anderes Konto.
• Committe keine Tokens und füg sie nicht in öffentliche Kanäle ein.
• Widerrufe einen Token unter Einstellungen → Integrationen. Das Limit sind 10 aktive Tokens.
• generate_company_md, get_cached_company_md, analyze_tone_of_voice und analyze_design_system funktionieren ohne Token und sind pro IP begrenzt.

Credits

start_research, start_write und rewrite_article verbrauchen je einen Artikel-Credit. start_research läuft außerdem höchstens einmal pro Projekt und Tag. Projekte, den Tresor oder den Job-Status lesen verbraucht keinen Credit. Ohne Testphase oder aktiven Tarif antworten Konto-Tools mit „Start a plan.“

Fehlerbehebung

• 401. Der Bearer-Token fehlt, ist widerrufen oder kein gehirn.md-Token. Erstelle einen neuen und setze ihn in den Authorization-Header als Bearer, gefolgt von einem Leerzeichen.
• Authorization verschwindet. Der Client hat https://gehirn.md aufgerufen und ist einer Weiterleitung gefolgt. Nutze https://www.gehirn.md/api/mcp. Weiterleitungen verwerfen den Authorization-Header.
• Start a plan. Das Konto hat einen Token, aber das Abo ist weder in der Testphase noch aktiv.