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.

Workspace-keuze

De MCP-server staat op https://picasi.app/mcp, zonder Workspace in het adres.

Aanmelding	Workspace
API-token	vast, de Workspace van het token; geen parameter nodig
OAuth	alle Workspaces van het account; elke aanroep heeft `workspace_id` nodig

Bij OAuth levert list_workspaces de mogelijke waarden. Zonder workspace_id wordt de aanroep afgewezen.

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	Thema-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 Workspace.

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.

Bij elk kanaal komen drie velden die uit elkaar gehouden moeten worden:

Veld	Betekenis
`monitoring_active`	De schakelaar van het kanaal: aan of uit. Geen gezondheidstoestand.
`state`	De toestand van het ophalen: `healthy`, `degraded`, `broken`, `quarantined` of `paused`. E-mailkanalen worden niet opgehaald maar ontvangen; die melden `receiving`, `stale` of `waiting`. `null` betekent dat er nog geen ophaling aan hangt.
`last_checked`	De laatste ophaalpoging, bij e-mailkanalen het laatst ontvangen bericht.

Voor de volledige diagnose van één kanaal is get_channel_status bedoeld.

`list_reports`

Geeft een overzicht van beschikbare 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 Workspace 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 Workspace.

Vereiste scope: read

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

`get_update_statistics`

Telt Updates in plaats van ze op te sommen. Neemt dezelfde filters als search_updates en kent geen bovengrens van 100 resultaten.

Vereiste scope: read

Parameter	Type	Beschrijving
`group_by`	Tekst	`source` (standaard), `source_tag`, `update_tag`, `day`, `week`, `month`, `quarter`
`compare_previous_period`	Booleaanse waarde	Telt daarnaast de even lange periode ervoor en geeft het verschil
`query`	Tekst	Zoekterm voor volledige tekst (optioneel)
`source_id`	Tekst	Beperken tot één bron (optioneel)
`source_tags`	Array	Brontags (optioneel)
`update_tags`	Array	Thema-tags (optioneel)
`source_ownership`	Tekst	`all` (standaard), `own` of `competitor`
`platform`	Tekst	Beperken tot één platform, bijv. `linkedin` (optioneel)
`folder`	Array	`inbox`, `saved`; standaard beide
`days`	Geheel getal	Periode in dagen, 1 tot 365 (standaard: 30)
`date_from`, `date_to`	Tekst	Periode als datum, in plaats van `days`

Groeperen per platform kan niet. Verworpen Updates en Updates in de Overflow worden niet meegeteld.

`get_channel_status`

Geeft de toestand van een kanaal terug: laatste ophaalactie, laatste succes, laatste fout, aantal opeenvolgende mislukkingen, volgende geplande poging en het aantal Updates uit dit kanaal.

Vereiste scope: read

Parameter	Type	Beschrijving
`channel_id`	Tekst	Kanaal-ID, uit `list_sources` met `include_channels=true`

`discover_channels`

Onderzoekt een website en meldt de kanalen die gevolgd zouden kunnen worden. Maakt niets aan.

Vereiste scope: read

Parameter	Type	Beschrijving
`url`	Tekst	Te onderzoeken website (optioneel als `source_id` is gezet)
`source_id`	Tekst	Gebruikt de website van deze bron en markeert de kanalen die ze al heeft

`list_workspaces`

Somt de Workspaces van het aangemelde account op met workspace_id, naam en rol.

Vereiste scope: geen; de tool staat open voor elke verbinding

Zonder parameters.

Rapporttools

`create_report`

Maakt een rapport van de Updates die op een filter passen. De filters zijn dezelfde als bij search_updates.

Het maken loopt op de achtergrond: de aanroep levert meteen een request_id. get_report_status zegt hoe ver het staat, get_report leest het afgeronde rapport.

Vereiste scope: read

Parameter	Type	Beschrijving
`type`	Tekst	Verplicht. `summary`, `feedback`, `list` of `conversation_starters`
`title`	Tekst	Naam van het rapport (optioneel)
`instructions`	Tekst	Focus voor de AI (optioneel)
`language`	Tekst	Taalcode, bijv. `de`; standaard de taal van de Workspace
`query`	Tekst	Zoekterm voor volledige tekst (optioneel)
`source_ids`	Array	Beperken tot deze bronnen (optioneel)
`source_tags`	Array	Brontags (optioneel)
`source_tags_mode`	Tekst	`AND` of `OR`
`update_tags`	Array	Thema-tags (optioneel)
`update_tags_mode`	Tekst	`AND` of `OR`
`source_ownership`	Tekst	`all`, `own` of `competitor`
`platform`	Tekst	Beperken tot één platform (optioneel)
`folder`	Array	Mappen van de databasis; standaard `inbox` en `saved`
`days`	Geheel getal	Periode in dagen, 1 tot 365 (standaard: 30)
`date_from`, `date_to`	Tekst	Periode als datum, in plaats van `days`

`get_report_status`

Geeft de stand terug van een rapport dat met create_report is opgedragen.

Vereiste scope: read

Parameter	Type	Beschrijving
`request_id`	Tekst	De `request_id` uit `create_report`

Status	Betekenis
`queued`	wacht in de wachtrij
`running`	wordt gemaakt
`ready`	klaar; lees het met `get_report` en de `report_id`
`empty`	klaar, maar geen Update paste op de filters
`failed`	afgebroken; de reden staat in het antwoord

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)

`update_update_state`

Verplaatst Updates tussen de mappen van de Workspace.

Vereiste scope: write

Parameter	Type	Beschrijving
`update_ids`	Array	Update-ID’s, hoogstens 100 per aanroep
`folder`	Tekst	`inbox`, `saved` of `dropped`

De toestand geldt per Workspace en verandert de Update zelf niet. Het antwoord meldt elk ID afzonderlijk.

`tag_update`

Kent bestaande thema-tags toe aan Updates.

Vereiste scope: write

Parameter	Type	Beschrijving
`update_ids`	Array	Update-ID’s, hoogstens 100 per aanroep
`tags`	Array	Tags als slug, ID of naam
`mode`	Tekst	`add` (standaard) behoudt bestaande tags, `replace` zet precies deze

Alleen tags met applies_to = updates zijn toegestaan; een brontag wordt geweigerd. Maak ontbrekende tags eerst aan met create_tag.

`untag_update`

Verwijdert thema-tags van Updates.

Vereiste scope: write

Parameter	Type	Beschrijving
`update_ids`	Array	Update-ID’s, hoogstens 100 per aanroep
`tags`	Array	Te verwijderen tags, als slug, ID of naam

Alleen de toewijzing van deze Workspace wordt verwijderd. De tag zelf blijft bestaan.

`refresh_source_channels`

Voert de kanaalherkenning opnieuw uit voor een bestaande bron.

Vereiste scope: write

Parameter	Type	Beschrijving
`source_id`	Tekst	ID van de bron
`create_detected`	Booleaanse waarde	`false` (standaard) meldt alleen, `true` maakt de ontbrekende kanalen aan

Bestaande kanalen worden niet dubbel aangemaakt; een uitgeschakeld kanaal telt als bestaand. Nieuwe kanalen beginnen vanzelf met ophalen.

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.