MCP-tools — Overzicht

Toegangsrechten

MCP-tools worden ingedeeld in drie scope-niveaus:

Scope	Betekenis
`read`	Alleen-lezen-toegang; geen aanmaken, bewerken of verwijderen
`write`	Lezen en schrijven van bronnen, kanalen, inbox; geen toegang tot teaminstellingen
`admin`	Volledige MCP-toegang inclusief teaminstellingen

Bij OAuth-verbindingen bepaalt het bij de autorisatie gekozen bereik welke tools kunnen worden opgeroepen. Bij API-tokens bepaalt de tokenrol de maximale toegangsrechten.

Lees-tools

Voor alle lees-tools is minimaal scope read vereist.

`search_updates`

Doorzoekt updates op zoektermen, bronnen, tags en periode.

Vereiste scope: read

Parameter	Type	Beschrijving
`query`	Tekst	Zoekterm in volledige tekst (optioneel)
`source_id`	Tekst	Updates van een bepaalde bron (optioneel)
`tags`	Array	Update-tags waarop wordt gefilterd (optioneel)
`folder`	Tekst	`inbox`, `saved` of `dropped` (optioneel)
`source_ownership`	Tekst	`all` (standaard), `own` (alleen eigen bronnen) of `competitor` (alleen externe bronnen)
`limit`	Geheel getal	Aantal resultaten (standaard: 20, max.: 100)

Het filter source_ownership maakt gebruik van het veld is_own bij de bron. Het is de tegenhanger van het ‘Ownership’-filter in de Inbox-UI en stelt de AI-assistent in staat om gericht alleen de eigen aanwezigheid of alleen concurrenten te bekijken.

`get_update_details`

Geeft de volledige inhoud van een enkele update terug.

Vereiste scope: read

Parameter	Type	Beschrijving
`update_id`	Tekst	ID van de update

`list_sources`

Geeft een overzicht van alle bronnen van de werkruimte.

Vereiste scope: read

Parameter	Type	Beschrijving
`is_own`	Booleaanse waarde	`true` = alleen eigen bronnen, `false` = alleen concurrenten, weglaten = alle

Elke geretourneerde bron bevat het veld is_own, zodat AI-assistenten hun eigen aanwezigheid en die van concurrenten kunnen onderscheiden zonder een tweede verzoek te hoeven indienen.

`list_reports`

Geeft een overzicht van beschikbare AI-rapporten.

Vereiste scope: read

Parameter	Type	Beschrijving
`type`	Tekst	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (optioneel)
`limit`	Geheel getal	Aantal (standaard: 10)

`get_report`

Geeft de volledige inhoud van een rapport terug.

Vereiste scope: read

Parameter	Type	Beschrijving
`report_id`	Tekst	ID van het rapport

`get_team_context`

Geeft de AI-context van de werkruimte terug: teammetadata (naam, taal, tijdzone), website-URL, contextdocumenten en de eigendomsconfiguratie.

Vereiste scope: read

Geen verplichte parameters.

Het antwoord bevat in het context-blok:

website_url – opgeslagen organisatie-URL
is_own_sources_configured – true, zodra ten minste één bron als eigen bron is gemarkeerd
own_sources_count – aantal eigen bronnen

AI-assistenten mogen alleen Voice-Share- of Momentum-vergelijkingen aanbieden als is_own_sources_configured true is — anders ontbreekt de vergelijkingsbasis.

`list_tags`

Geeft een overzicht van alle tags van de werkruimte.

Vereiste scope: read

Parameter	Type	Beschrijving
`type`	Tekst	`sources`, `channels`, `updates` (optioneel)

Schrijftools

Voor alle schrijftools is minimaal scope write vereist.

`create_source`

Maakt een nieuwe bron aan.

Vereiste scope: write

Parameter	Type	Beschrijving
`url`	Tekst	Website-URL van de bron
`name`	Tekst	Interne naam
`tags`	Array	Tag-ID’s (optioneel)

`update_source`

Wijzigt de naam, URL of tags van een bestaande bron.

Vereiste scope: write

Parameter	Type	Beschrijving
`source_id`	Tekst	ID van de bron
`name`	Tekst	Nieuwe naam (optioneel)
`url`	Tekst	Nieuwe URL (optioneel)

`delete_source`

Verwijdert een bron inclusief alle kanalen en updates.

Vereiste scope: write

Parameter	Type	Beschrijving
`source_id`	Tekst	ID van de bron

`create_channel`

Maakt handmatig een kanaal aan.

Vereiste scope: write

Parameter	Type	Beschrijving
`source_id`	Tekst	ID van de bovenliggende bron
`url`	Tekst	Kanaal-URL
`name`	Tekst	Kanaalnaam (optioneel)

`update_channel`

Wijzigt de naam of beschrijving van een kanaal.

Vereiste scope: write

Parameter	Type	Beschrijving
`channel_id`	Tekst	ID van het kanaal
`name`	Tekst	Nieuwe naam (optioneel)

`delete_channel`

Verwijdert een kanaal.

Vereiste scope: write

Parameter	Type	Beschrijving
`channel_id`	Tekst	ID van het kanaal

`toggle_channel`

Schakelt een kanaal in of uit.

Vereiste scope: write

Parameter	Type	Beschrijving
`channel_id`	Tekst	ID van het kanaal
`active`	Booleaanse waarde	`true` = actief, `false` = inactief

`create_tag`

Maakt een nieuwe tag aan.

Vereiste scope: write

Parameter	Type	Beschrijving
`name`	Tekst	Tagnaam
`type`	Tekst	`sources`, `channels` of `updates`
`description`	Tekst	KI-taggingbeschrijving (optioneel)

`update_tag`

Wijzigt de naam of beschrijving van een tag.

Vereiste scope: write

Parameter	Type	Beschrijving
`tag_id`	Tekst	ID van de tag
`name`	Tekst	Nieuwe naam (optioneel)
`description`	Tekst	Nieuwe AI-beschrijving (optioneel)

Gerelateerde onderwerpen

MCP — Picasi gebruiken in de AI-assistent Achtergrond: Wat MCP is, OAuth-scope-niveaus en het beveiligingsconcept.

Picasi koppelen aan Claude Code Een API-token aanmaken en instellen in Claude Code.

Picasi koppelen aan Claude.ai Een OAuth-verbinding voor Claude.ai instellen.