MCP-Tools — Übersicht
Zugriffsrechte
MCP-Tools werden drei Scope-Leveln zugeordnet:
| Scope | Bedeutung |
|---|---|
read | Nur lesender Zugriff; kein Anlegen, Bearbeiten oder Löschen |
write | Lesen und Schreiben von Quellen, Kanälen, Inbox; kein Zugriff auf Team-Einstellungen |
admin | Voller MCP-Zugriff inklusive Team-Einstellungen |
Bei OAuth-Verbindungen begrenzt der beim Autorisieren gewählte Scope, welche Tools aufrufbar sind. Bei API-Tokens bestimmt die Token-Rolle das Zugriffsmaximum.
Read-Tools
Alle Read-Tools erfordern mindestens Scope read.
search_updates
Durchsucht Updates nach Suchbegriffen, Quellen, Tags und Zeitraum.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
query | String | Volltext-Suchbegriff (optional) |
source_id | String | Updates einer bestimmten Quelle (optional) |
tags | Array | Update-Tags, nach denen gefiltert wird (optional) |
folder | String | inbox, saved oder dropped (optional) |
limit | Integer | Anzahl der Ergebnisse (Standard: 20, max: 100) |
get_update_details
Gibt den vollständigen Inhalt eines einzelnen Updates zurück.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
update_id | String | ID des Updates |
list_sources
Listet alle Quellen des Workspace.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
active_only | Boolean | Nur aktive Quellen zurückgeben (Standard: true) |
list_reports
Listet verfügbare KI-Berichte.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
type | String | summary, feedback, list, linkedin_post, conversation_starters (optional) |
limit | Integer | Anzahl (Standard: 10) |
get_report
Gibt den vollständigen Inhalt eines Berichts zurück.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
report_id | String | ID des Berichts |
get_team_context
Gibt den KI-Kontext des Workspace zurück (Website-URL und Kontext-Dokumente).
Erforderlicher Scope: read
Keine Parameter.
list_tags
Listet alle Tags des Workspace.
Erforderlicher Scope: read
| Parameter | Typ | Beschreibung |
|---|---|---|
type | String | sources, channels, updates (optional) |
Write-Tools
Alle Write-Tools erfordern mindestens Scope write.
create_source
Legt eine neue Quelle an.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
url | String | Website-URL der Quelle |
name | String | Interner Name |
tags | Array | Tag-IDs (optional) |
update_source
Ändert Name, URL oder Tags einer bestehenden Quelle.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
source_id | String | ID der Quelle |
name | String | Neuer Name (optional) |
url | String | Neue URL (optional) |
delete_source
Löscht eine Quelle inklusive aller Kanäle und Updates.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
source_id | String | ID der Quelle |
create_channel
Legt einen Kanal manuell an.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
source_id | String | ID der übergeordneten Quelle |
url | String | Kanal-URL |
name | String | Kanalname (optional) |
update_channel
Ändert Name oder Beschreibung eines Kanals.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
channel_id | String | ID des Kanals |
name | String | Neuer Name (optional) |
delete_channel
Löscht einen Kanal.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
channel_id | String | ID des Kanals |
toggle_channel
Aktiviert oder deaktiviert einen Kanal.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
channel_id | String | ID des Kanals |
active | Boolean | true = aktiv, false = inaktiv |
create_tag
Legt einen neuen Tag an.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
name | String | Tag-Name |
type | String | sources, channels oder updates |
description | String | KI-Tagging-Beschreibung (optional) |
update_tag
Ändert Name oder Beschreibung eines Tags.
Erforderlicher Scope: write
| Parameter | Typ | Beschreibung |
|---|---|---|
tag_id | String | ID des Tags |
name | String | Neuer Name (optional) |
description | String | Neue KI-Beschreibung (optional) |