DokumentationAPI-Referenz
Workspace
Der Workspace, seine Nutzung, die Suche, Skills, Tool-Einstellungen und Konnektoren.
Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).
| Operation | Aufruf | |
|---|---|---|
| Workspace abrufen | GET /workspace | Kostenlos |
| Nutzung abrufen | GET /usage | Kostenlos |
| Skills auflisten | GET /skills | Kostenlos |
| Konnektoren auflisten | GET /connectors | Kostenlos |
| Workspace durchsuchen | POST /search | Kostenlos |
| Workspace ändern | PATCH /workspace | Kostenlos |
| Skill ein- oder ausschalten | PATCH /skills/{skillId} | Kostenlos |
| Tool-Einstellungen auflisten | GET /workspace/tools | Kostenlos |
| Tool-Einstellungen einer Website auflisten | GET /sites/{siteId}/tools | Kostenlos |
| Tool ein- oder ausschalten | PATCH /workspace/tools | Kostenlos |
| Konnektor trennen | DELETE /connectors/{provider} | Kostenlos |
| Konnektor einer Website trennen | DELETE /sites/{siteId}/connectors/{provider} | Kostenlos |
Workspace abrufen
/workspaceKostenlosDer Workspace, sein Plan und wie viel der Credits des Zeitraums verbraucht ist.
- Credits werden nie als Rohzahlen angezeigt, nur als Prozentsatz des Zeitraums.
MCP-Tool get_workspace
curl https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01995d03-8ea0-79ee-8ee3-c2eed260b3bc",
"name": "Acme",
"plan": {
"id": "starter",
"name": "Starter",
"features": {
"gsc": true,
"market_data": true,
"agents": 11,
"backlinks": true,
"weekly_reports": true,
"ai_writer": true
}
},
"balance": {
"used_pct": 12.5,
"remaining_pct": 87.5,
"period_resets_at": "2026-11-12T13:26:58.000Z"
},
"settings": {
"description": null,
"custom_instructions": "Nous sommes une agence SEO lyonnaise.",
"company_name": null,
"company_website": null,
"company_siren": null,
"company_address": null
}
}
}Nutzung abrufen
/usageKostenlosDie Nutzung im aktuellen Zeitraum, in Prozent, nach Kategorie aufgeteilt.
MCP-Tool get_usage
curl https://app.semchat.io/api/v1/usage \
-H "Authorization: Bearer sk_live_…"{
"data": {
"period": "current",
"used_pct": 12.5,
"remaining_pct": 87.5,
"by_category_pct": {
"conversations": 2.5,
"seo_tools": 2.5,
"visuals": 2.5,
"documents": 2.5,
"site_analysis": 2.5
}
}
}Skills auflisten
/skillsKostenlosDie Skills, die dem Chat des Workspaces zur Verfügung stehen.
MCP-Tool list_skills
curl https://app.semchat.io/api/v1/skills \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "cocon-semantique",
"name": "Topic cluster",
"when_to_use": "Quand l'utilisateur demande : cocon sémantique.",
"enabled": true
},
{
"id": "seo-audit",
"name": "SEO audit",
"when_to_use": "Quand l'utilisateur demande : audit seo.",
"enabled": true
}
]
}Konnektoren auflisten
/connectorsKostenlosAuf Workspace-Ebene verbundene Tools (Search Console, GA4, Slack, Notion…).
- Die meisten Verbindungen gelten pro Website: siehe list_site_connectors.
MCP-Tool list_connectors
curl https://app.semchat.io/api/v1/connectors \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Workspace durchsuchen
/searchKostenlosDurchsucht die Unterhaltungen, Websites, geplanten Aufgaben, Konnektoren und Skills des Workspaces nach Name, Adresse, Nachricht oder Konto, wie die Suche der App (⌘K).
- Jede Art kommt mit
more: true, wenn es weitere als die zurückgegebenen gibt. - Unterhaltungen werden über ihren Titel gesucht.
MCP-Tool search_workspace
| Argument | Typ | Beschreibung |
|---|---|---|
queryerforderlich | string | Wonach gesucht wird, unabhängig von Akzenten und Groß- und Kleinschreibung. Leer: die neuesten jeder Art.bis zu 100 Zeichen |
limitoptional | integer | Höchstens so viele pro Art (Standard und Maximum 50).≥ 1, ≤ 50 |
curl -X POST https://app.semchat.io/api/v1/search \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"query": "…"}'Antwortet 200 mit { "data": … }.
Workspace ändern
/workspaceKostenlosDie Einstellungen des Workspaces ändern: Name, Beschreibung, persönliche Anweisungen für den Assistenten, Firmenangaben.
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
- Nur die angegebenen Felder ändern sich; ein leerer Text (oder null) leert ein Feld. Mindestens ein Feld ist erforderlich.
MCP-Tool update_workspace
| Argument | Typ | Beschreibung |
|---|---|---|
nameoptional | string | 1–255 Zeichen |
descriptionoptional | string | null | |
custom_instructionsoptional | string | null | Anweisungen, die der Assistent in jeder Unterhaltung des Workspaces befolgt. |
company_nameoptional | string | null | |
company_websiteoptional | string | null | |
company_sirenoptional | string | null | Die Registriernummer des Unternehmens. |
company_addressoptional | string | null |
curl -X PATCH https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Antwortet 200 mit { "data": … }.
Skill ein- oder ausschalten
/skills/{skillId}KostenlosEinen Skill des Workspaces für dessen Chat ein- oder ausschalten.
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
MCP-Tool set_skill
| Argument | Typ | Beschreibung |
|---|---|---|
skillIdim Pfad | string | Die ID. |
enablederforderlich | boolean |
curl -X PATCH https://app.semchat.io/api/v1/skills/{skillId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"enabled": true}'Antwortet 200 mit { "data": … }.
Tool-Einstellungen auflisten
/workspace/toolsKostenlosDie Tools der Konnektoren, die der Assistent nutzen darf, jeweils für den Workspace ein- oder ausgeschaltet.
- Ein Tool ist eingeschaltet, solange es nicht ausgeschaltet wurde. Jede Website übernimmt diese Einstellungen, außer sie legt eigene fest: siehe list_site_tool_prefs.
MCP-Tool list_tool_prefs
curl https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Tool-Einstellungen einer Website auflisten
/sites/{siteId}/toolsKostenlosDie Tools der Konnektoren, die der Assistent in den Unterhaltungen dieser Website nutzen darf, jeweils ein- oder ausgeschaltet.
- Die eigene Wahl der Website, wenn sie eine getroffen hat, sonst die des Workspaces.
MCP-Tool list_site_tool_prefs
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/tools \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Tool ein- oder ausschalten
/workspace/toolsKostenlosEin Tool für den Assistenten ein- oder ausschalten, für den Workspace oder für eine Website.
MCP-Tool set_tool_pref
| Argument | Typ | Beschreibung |
|---|---|---|
tool_nameerforderlich | string | Das Tool, so wie list_tool_prefs es benennt.1–64 Zeichen |
enablederforderlich | boolean | |
site_idoptional | string | Nur für diese Website (Standard: der Workspace).mindestens 1 Zeichen |
curl -X PATCH https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"tool_name": "…", "enabled": true}'Antwortet 200 mit { "data": … }.
Konnektor trennen
/connectors/{provider}KostenlosEin auf Workspace-Ebene verbundenes Tool trennen (sein gespeicherter Zugriff wird gelöscht).
- provider, wie list_connectors ihn anzeigt (google_search_console, google_analytics_4, notion, slack, wordpress, webflow, microsoft_clarity, bing_webmaster_tools, yandex_metrica).
- Die eigenen Verbindungen der Websites bleiben unberührt: siehe disconnect_site_connector. Ein Tool verbinden Sie in der App.
MCP-Tool disconnect_connector
| Argument | Typ | Beschreibung |
|---|---|---|
providerim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Konnektor einer Website trennen
/sites/{siteId}/connectors/{provider}KostenlosEin mit dieser Website verbundenes Tool trennen (sein gespeicherter Zugriff wird gelöscht).
- provider, wie list_site_connectors ihn anzeigt.
MCP-Tool disconnect_site_connector
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
providerim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

