MCP

MCP-Server verbinden

Teddit hat einen eingebauten MCP-Server. Verbinden Sie ihn mit Claude, Cursor oder einem anderen MCP-Client, und Ihre eigene KI kann jede Antwort, Quelle und Zahl in Ihrem Workspace lesen, Prompts und Wettbewerber verwalten und Scans starten, wenn der Schlüssel es erlaubt.

Was Sie bekommen

Der Server ist Teil von Teddit. Auf unserer Seite ist nichts zu installieren oder bereitzustellen.

PunktWert
Adressehttps://teddit.io/mcp
TransportStreamable HTTP, zustandslos: Jede Anfrage steht für sich, es gibt keine Sitzung, die offen gehalten werden muss.
AuthentifizierungEin Workspace-API-Schlüssel im Header Authorization: Bearer tdt_…
Inhalt30 Werkzeuge, eine Ressource (teddit://projects) und zwei Prompt-Vorlagen (weekly_review, grow_prompt_set). Alle sind in der Werkzeugreferenz aufgeführt.

Jeder Werkzeugaufruf bekommt dieselben Prüfungen wie die Web-App. Ein Schlüssel kann nie mehr, als seine Zugangsstufe erlaubt, und nichts, was ein Werkzeug tut, bleibt der App verborgen: Ein über MCP gestarteter Scan erscheint im Scan-Verlauf wie jeder andere.

Lesen ist kostenlos. Ein Werkzeug kostet Geld: start_scan startet einen Scan, bezahlt aus dem Guthaben des Workspace. rewrite_queries wird nicht berechnet, braucht aber ein Guthaben über null.

Einen Schlüssel erstellen

  1. Klicken Sie in der App das Zahnrad-Symbol in der oberen Leiste und öffnen Sie den Reiter API & MCP.
  2. Drücken Sie Schlüssel erstellen. Geben Sie ihm einen Namen, der sagt, wo er verwendet wird, zum Beispiel „Claude auf meinem Laptop“.
  3. Wählen Sie den Zugang: Lesen, Lesen + Bearbeiten oder Lesen + Scannen.
  4. Kopieren Sie den Schlüssel. Er beginnt mit tdt_ und wird einmal angezeigt. Teddit behält nur einen Fingerabdruck davon und kann ihn nicht erneut anzeigen.

Jeder im Workspace kann einen Schlüssel erstellen; was er darf, hängt von der Rolle der Person ab. Ein Schlüssel gehört zu einem Workspace. Solange der Dialog mit dem neuen Schlüssel offen ist, sind die Konfigurationsausschnitte auf der Seite API & MCP damit ausgefüllt, bereit zum Kopieren.

Um einen Schlüssel außer Betrieb zu nehmen, drücken Sie das Papierkorb-Symbol daneben. Er funktioniert sofort nicht mehr. Mehr zu Schlüsseln: Authentifizierung.

Claude

Claude Code

Ein Befehl fügt den Server über HTTP hinzu:

claude mcp add --transport http teddit https://teddit.io/mcp \
  --header "Authorization: Bearer tdt_…"

Claude Desktop

Claude Desktop startet MCP-Server als lokale Programme aus seiner Konfigurationsdatei. Eine kleine Brücke, das Open-Source-Paket mcp-remote, verbindet es mit Teddits Adresse und sendet den Schlüssel. Sie braucht Node.js. Fügen Sie dies in claude_desktop_config.json ein und starten Sie Claude neu:

{
  "mcpServers": {
    "teddit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://teddit.io/mcp", "--header", "Authorization:${TEDDIT_AUTH}"],
      "env": {
        "TEDDIT_AUTH": "Bearer tdt_…"
      }
    }
  }
}

Der Schlüssel kommt in TEDDIT_AUTH, nach Bearer und einem Leerzeichen.

ChatGPT

ChatGPT fügt entfernte MCP-Server als Connectors hinzu, über die Adresse. Um Teddit zu verbinden, muss der Connector Ihren Schlüssel im Header Authorization senden:

Name:  Teddit
URL:   https://teddit.io/mcp
Auth:  Bearer tdt_…
Teddit akzeptiert einen Schlüssel im Header Authorization und sonst nichts. Es hat keine OAuth-Anmeldung. Ein Client, dessen Connector-Formular nur OAuth anbietet, oder keine Möglichkeit, einen Header zu senden, kann sich nicht direkt verbinden.

Cursor und andere Clients

Jeder Client, der MCP über Streamable HTTP spricht und einen Header senden kann, funktioniert. Für Cursor tragen Sie dies in .cursor/mcp.json ein:

{
  "mcpServers": {
    "teddit": {
      "type": "http",
      "url": "https://teddit.io/mcp",
      "headers": {
        "Authorization": "Bearer tdt_…"
      }
    }
  }
}

Für einen Client, den Sie von Hand konfigurieren, sind dies die drei Angaben, die er braucht:

  • die Adresse https://teddit.io/mcp;
  • den Transport: Streamable HTTP;
  • den Header Authorization: Bearer tdt_… bei jeder Anfrage.

Ein Client, der nur lokale Programme starten kann, kann die Brücke mcp-remote verwenden, die unter Claude Desktop gezeigt ist.

Die Verbindung prüfen

Fragen Sie Ihre KI: „Nutze Teddit und sag mir, mit welchem Workspace du verbunden bist.“ Sie sollte whoami aufrufen und mit dem Namen des Workspace und der Zugangsstufe des Schlüssels antworten.

Um einen Schlüssel ohne Client zu testen, rufen Sie die API direkt auf:

curl https://teddit.io/api/whoami \
  -H "Authorization: Bearer tdt_…"
Was Sie sehenWas es bedeutet
HTTP 401 von /mcpEs wurde kein Schlüssel gesendet, der Header hat nicht die Form Bearer tdt_…, oder der Schlüssel wurde widerrufen. Eine Browser-Anmeldung zählt hier nicht; die MCP-Adresse nimmt nur Schlüssel an.
Ein Werkzeug antwortet Error: You do not have permission to do that.Die Zugangsstufe des Schlüssels ist für dieses Werkzeug zu niedrig. Erstellen Sie einen Schlüssel mit mehr Zugang.
Ein Werkzeug antwortet Error: Project not found.Die Site-ID ist falsch, oder die Site gehört zu einem anderen Workspace. IDs kommen von list_projects.

Was ein Schlüssel darf

ZugangWerkzeuge, die er nutzen kann
LesenAlles, was liest: Berichte, Trends, Prompts und ihre Antworten, Wettbewerber, Seiten, Scan-Verlauf und -Fortschritt, Kostenschätzungen, Diagramme.
Lesen + BearbeitenDas Obige, und: Prompts hinzufügen, bearbeiten, pausieren, importieren und löschen; Wettbewerber hinzufügen, bearbeiten und entfernen; die Einstellungen einer Site ändern; die Sitemap erneut lesen.
Lesen + ScannenDas Obige, und: Scans starten und abbrechen, importierte Suchanfragen zu Fragen umschreiben und eine Site anlegen.

Sie können keinen Schlüssel mit mehr Zugang erstellen, als Sie selbst haben. Mit einem Schlüssel gestartete Scans werden aus demselben Guthaben bezahlt und zählen zu denselben Limits wie in der App gestartete Scans, und sie werden unter dem Namen der Person erfasst, die den Schlüssel erstellt hat.

Weiter: die Werkzeugreferenz und einige Beispielfragen.