MCP — Picasi gebruiken in de AI-assistent
Wat is MCP?
Het Model Context Protocol (MCP) is een open protocol dat bepaalt hoe AI-assistenten toegang krijgen tot externe tools en gegevens. In plaats van dat elke aanbieder een eigen integratie moet bouwen, volgen ze allemaal dezelfde standaard.
Claude Code, Claude.ai, ChatGPT en andere assistenten die MCP ondersteunen, kunnen verbinding maken met elke MCP-compatibele dienst — en Picasi is daar een van.
Waarom Picasi MCP implementeert
Concurrentieanalyse wordt pas echt nuttig als de informatie beschikbaar is op de plek waar je werkt — niet in een aparte app die je apart moet openen.
Als je een concurrentieanalyse schrijft in Claude en halverwege je werk wilt weten wat Muster AG vorige week heeft gecommuniceerd, vraag je het gewoon aan Claude. Claude vraagt op de achtergrond via MCP aan Picasi — en je ziet de gegevens direct in de chat, zonder van context te wisselen.
Dat is het echte voordeel van MCP: Picasi-gegevens worden geïntegreerd in jullie bestaande AI-workflow, in plaats van dat er een aparte workflow wordt opgelegd.
Hoe de koppeling werkt
Er zijn twee manieren om Picasi te koppelen aan een AI-assistent:
API-token — voor Claude Code, Cursor en eigen agents. Je maakt een token aan in Picasi, voert deze in de configuratie van de assistent in en hij heeft meteen toegang. Het token heeft een rol die de omvang van de toegang bepaalt.
OAuth — voor Claude.ai en ChatGPT. Je autoriseert de assistent rechtstreeks via je Picasi-account, zonder tokenbeheer. De koppeling is gekoppeld aan je persoonlijke account.
Wat de assistent kan doen
Met leestoegang kan de assistent:
- Updates zoeken en lezen
- Bronnen en kanalen weergeven
- Rapporten opvragen
- de teamcontext (AI-context) opvragen
Met schrijftoegang (beheerders-token of OAuth met write-scope) kan de assistent bovendien:
- bronnen aanmaken, bewerken en verwijderen
- kanalen aanmaken, bewerken en deactiveren
- Tags aanmaken en bewerken
OAuth-scopeniveau
Wanneer je een OAuth-verbinding instelt — bijvoorbeeld met Claude.ai of ChatGPT — kies je tijdens de autorisatiestap een autorisatieniveau (autorisatieniveau). Dit niveau fungeert als een limiet: het bepaalt wat de assistent via deze verbinding mag doen, ongeacht jullie rol in de werkruimte.
| Niveau | Toegestaan | Niet toegestaan |
|---|---|---|
| Alleen-lezen | Updates lezen, bronnen en rapporten ophalen, teamcontext opvragen | Bronnen of kanalen aanmaken, bewerken of verwijderen |
| Read & Write (standaard) | Alles uit Read-only plus bronnen, kanalen en inbox beheren | Team-instellingen en AI-instellingen beheren |
| Admin | Alle MCP-bewerkingen inclusief team-instellingen | Facturering beheren |
De niveaus die je kunt kiezen, worden beperkt door je eigen workspace-rol. Een lid zonder beheerdersrechten ziet de optie Admin niet.
Het gekozen bereik blijft permanent aan de verbinding gekoppeld. Na autorisatie is het als badge zichtbaar in de verbindingslijst. Om het bereik te wijzigen, moet de verbinding worden ingetrokken en opnieuw worden ingesteld.
Aanbeveling: Kies het bereik dat voldoende is voor het specifieke gebruiksdoel — dus niet meer toegang dan nodig is. Voor louter opvragingen en analyses volstaat Read-only.
Hoe lang is een verbinding geldig?
API-tokens hebben geen vervaldatum. Ze blijven geldig totdat je ze in Picasi onder Instellingen → API-tokens intrekt of totdat het betreffende lid de werkruimte verlaat. Een ingetrokken token wordt onmiddellijk ongeldig; er moet een nieuw token worden aangemaakt en in de client worden opgeslagen.
OAuth-verbindingen werken met twee tokens:
- Een toegangstoken, dat voor korte tijd geldig is en de afzonderlijke toolaanroep autoriseert.
- Een vernieuwingstoken, dat bruikbaar is zolang de verbinding bestaat — de client wisselt het op de achtergrond in voor nieuwe toegangstokens.
Zolang de assistent regelmatig toegang heeft, vernieuwt hij zichzelf. Als de verbinding langer dan ongeveer twee weken niet wordt gebruikt, kan het vernieuwingstoken verlopen — in dat geval geeft de assistent een autorisatiefout weer en moeten jullie de verbinding opnieuw instellen via Instellingen → AI-assistent verbinden.
Meerdere werkruimten tegelijk verbinden
Als je meerdere Picasi-werkruimten hebt (bijv. een bureau met meerdere klantaccounts), kun je per werkruimte een eigen verbinding aanmaken.
- API-token: genereer per werkruimte een eigen token. Vermeld elk token in de clientconfiguratie onder een eigen MCP-servernaam (
picasi-kunde-a,picasi-kunde-b). De assistent ziet de tools dan als afzonderlijke sets. - OAuth: voor Claude.ai en ChatGPT kan meestal slechts één verbinding per aanbieder actief worden gehouden. Voor bureaus wordt hier de methode met API-tokens en specifieke servernamen aanbevolen.
De get_team_context-aanroep geeft in het veld team.name te allen tijde aan met welke werkruimte de assistent op dat moment werkt — zo kan verwarring worden uitgesloten.
Beveiliging en controle
Jullie behouden de controle. Elke verbinding is in Picasi zichtbaar onder AI-verbindingen. Jullie kunnen deze op elk moment afzonderlijk intrekken — onmiddellijk en zonder restanten.
Tokens zijn rolgebonden: een lezer-token kan geen bronnen aanmaken, ongeacht hoe de assistent het gebruikt. Bij OAuth-verbindingen geldt bovendien het geselecteerde bereik als beperking.