SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Was es ist

Der MCP-Server befindet sich unter https://get-api.simplyboost.io/api/v1/mcp. Er verwendet den Streamable-HTTP-Transport und dasselbe API-Token wie die REST-API (Authorization: Bearer sb_live_…), dieselben Tarife (Growth, Pro und Enterprise), dieselben Berechtigungen und dieselben Limits. Jedes Tool tut dasselbe wie der entsprechende REST-Endpunkt und benötigt denselben Scope; sieht der Assistent ein Tool, das er nicht verwenden darf, erhält er eine klare Ablehnung statt eines Fehlers.

Der Server ist zustandslos: Jeder Aufruf besteht aus einer Anfrage und einer Antwort, ohne Sitzung, die aufrechterhalten werden muss. So kannst du dich von jedem Rechner aus verbinden. Der Server startet niemals selbst einen Stream.

Einen Client verbinden

Es gibt zwei Möglichkeiten. Anmelden (OAuth): Füge die Adresse des Servers hinzu und genehmige die Verbindung, wenn der Client dich dazu auffordert, in einem SimplyBoost-Tab als Teaminhaber. Wähle dabei das Team, die Berechtigungen und die Chatbots aus. So verbinden sich die Connectoren von claude.ai und ChatGPT, Cursor, Codex und Claude Code – ohne dass du etwas einfügen musst. Ein Token: Für einen Client, den du manuell konfigurierst, oder ein eigenes Skript erstellst du unter Settings → API ein Token mit nur den Berechtigungen, die der Assistent benötigt, und sendest es als Header.

Claude Code (anmelden, wenn du dazu aufgefordert wirst)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code und andere Clients mit einer mcp.json (bei Aufforderung anmelden)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Dasselbe, aber mit einem Token statt einer Anmeldung

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Eine durch Anmeldung hergestellte Verbindung ist 90 Tage lang gültig, erhält nur die Berechtigungen, die der Inhaber aktiviert gelassen hat (Löschen ist standardmäßig deaktiviert) und wird unter Settings → API → Connected apps aufgeführt. Dort kann der Inhaber die Verbindung jederzeit trennen. Nur ein Teaminhaber kann eine Verbindung genehmigen – dieselbe Regel gilt auch für das Erstellen eines Tokens. Der Name der App auf dem Genehmigungsbildschirm entspricht der Selbstangabe der App; SimplyBoost überprüft ihn nicht.

Ein Token in der Konfiguration eines Clients ist ein Passwort für dein Konto. Bewahre es auf deinem eigenen Rechner auf, lege ein Ablaufdatum fest und rotiere es, wenn die Konfigurationsdatei geteilt wird. Mit der Anmeldung vermeidest du dieses Problem: Es wird kein Geheimnis in eine Datei geschrieben.

Für Client-Entwickler: Der Server folgt der MCP-Autorisierungsspezifikation. Eine Anfrage ohne Zugangsdaten antwortet mit 401 und einem WWW-Authenticate-Header, der die Metadaten der geschützten Ressource (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp) angibt. Diese nennen den Autorisierungsserver (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Clients registrieren sich selbst (Dynamic Client Registration), verwenden den Authorization-Code-Flow mit PKCE (nur S256), können die Ressource angeben und erhalten rotierende Refresh-Tokens. Access-Tokens sind eine Stunde gültig und funktionieren nur am MCP-Endpunkt; für die REST-Endpunkte werden API-Tokens benötigt.

Die Tools

Argumente und Ergebnisse verwenden dieselben Namen wie die REST-API (chatbotId, threadId, camelCase-Felder), daher beschreiben die Endpunktseiten beides. Beginne mit list_chatbots, um die ID eines Chatbots zu finden.

Tool	Benötigt	Funktion
get_account	nichts	Das Konto, der Tarif und die eigenen Berechtigungen des Tokens.
get_usage	account:read	In diesem Abrechnungszeitraum verwendete Nachrichten.
list_chatbots, get_chatbot	chatbots:read	Die Chatbots, die das Token verwenden darf.
send_message	conversations:write	Einen Chatbot so fragen, wie es ein Besucher tun würde; wird auf das Nachrichtenkontingent des Tarifs angerechnet. Übergib threadId, um fortzufahren.
list_conversations, get_conversation, list_messages	conversations:read	Unterhaltungen auf allen Kanälen und ihre Nachrichten.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Eine Unterhaltung wie eine Person bearbeiten: übernehmen, antworten, zurückgeben, lösen oder wieder öffnen.
list_leads, get_lead	leads:read	Die von einem Chatbot erfassten Leads.
update_lead	leads:write	Die Angaben eines Leads ändern oder ihn als konvertiert markieren.
delete_lead	leads:delete	Einen Lead löschen.
list_knowledge_sources, get_knowledge_source	knowledge:read	Was ein Chatbot weiß, einschließlich Status und Text jeder Quelle.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Dem Chatbot Text oder eine Website beibringen, eine Quelle bearbeiten oder eine Website erneut einlesen.
delete_knowledge_source	knowledge:delete	Eine Quelle entfernen.

Datei-Uploads und Webhooks werden nicht als Tools angeboten; verwende dafür die REST-Endpunkte. Lösch-Tools sind als destruktiv gekennzeichnet, und die Anweisungen des Servers weisen den Assistenten an, dich vorher zu fragen.

Fehler und Limits

Ein abgelehnter Tool-Aufruf (fehlende Berechtigung, ein Chatbot, den das Token nicht sehen darf, ein ungültiges Argument oder ein Tariflimit) wird als Tool-Ergebnis mit einer Fehlermarkierung zurückgegeben. Es enthält denselben code-Wert und dieselbe Meldung wie die REST-API, sodass der Assistent dir sagen kann, was du ändern musst. Ein fehlendes oder ungültiges Token führt zu 401, ein Tarif ohne API-Zugang oder ein abgelaufenes Abonnement zu 403 und das Ratenlimit pro Token zu 429 – genau wie bei der REST-API.

Eine Nachricht, die nicht JSON-RPC 2.0 entspricht, führt zu einem JSON-RPC-Fehler. GET und DELETE am Endpunkt führen zu 405, da es keine Sitzung und keinen Server-Stream gibt.