Ga naar inhoud
Picasi Picasi Picasi Documentatie
Naar de app

Picasi koppelen aan Claude Code

Waar gaat het om?

Je stelt Picasi in als MCP-server in Claude Code. Daarna kun je in de Claude-chat direct vragen naar Updates van je concurrenten, bronnen beheren of rapporten opvragen — zonder de Picasi-app te openen.

Wat je nodig hebt

  • Een Picasi API-token (handleiding: API-token aanmaken)
  • De MCP-URL (te vinden onder Instellingen → AI-verbindingen en tokens)

Optie A: Configureren via de CLI

  1. Zorg dat je het token en de URL bij de hand hebt

    Open Instellingen → AI-verbindingen en tokens in Picasi en kopieer de MCP-URL. Die luidt https://picasi.app/mcp en is voor alle Workspaces hetzelfde: welke de server toont, bepaalt het token.

  2. MCP-server toevoegen

    Voer de volgende opdracht uit in een terminal:

    Terminal window
    claude mcp add picasi \
      --transport http \
      --url https://picasi.app/mcp \
      --header "Authorization: Bearer DEIN_TOKEN"

    Vervang DEIN_TOKEN door je token.

  3. Verbinding testen

    Start Claude Code en typ:

    Welke bronnen staan er in mijn Picasi-Workspace?

    Claude antwoordt met echte gegevens als de verbinding werkt.

Optie B: .mcp.json direct bewerken

Als je de configuratie liever als bestand in het project hebt:

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Sla dit bestand op als .mcp.json in de root van je project. Claude Code leest het automatisch.

Omgevingsvariabelen in plaats van platte tekst

Voor projecten waarvan het .mcp.json in Git staat, mag je het token nooit in platte tekst vermelden. Twee veilige manieren:

1. Globale Claude-Code-configuratie

In plaats van een projectspecifieke .mcp.json, stel je de server eenmalig globaal in:

Terminal window
claude mcp add picasi \
  --scope user \
  --transport http \
  --url https://picasi.app/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

De server is dan in alle projecten beschikbaar, zonder .mcp.json in de repository.

2. Omgevingsvariabele in een niet-gecommitteerd bestand

Voor projectspecifieke servers: .mcp.json in de repository committen, maar het token uit de omgeving lezen.

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PICASI_API_TOKEN}"
      }
    }
  }
}

Stel de variabele PICASI_API_TOKEN in een .env-bestand (in .gitignore) of direct in de shell waarin Claude Code wordt gestart:

Terminal window
export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code leest de variabele pas bij het opstarten in. Als het token wordt gewijzigd, moet Claude Code opnieuw worden gestart.

Meerdere Workspaces

Bij meerdere Picasi-Workspaces (bijv. een bureau met meerdere klanten) moet u per Workspace een eigen serververmelding aanmaken en deze een unieke naam geven:

{
  "mcpServers": {
    "picasi-kunde-a": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" }
    },
    "picasi-kunde-b": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" }
    }
  }
}

Het adres is in beide items hetzelfde, de Workspace zit in het token. Claude Code voert de tools van de servers uit onder afzonderlijke naamruimten (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), zodat er geen verwarring ontstaat.

Het oude adres met de Workspace-code

Oudere configuraties dragen een adres in de vorm https://picasi.app/mcp/t-xxxxxxxxxx, met de code van de Workspace aan het eind. Dat blijft ongewijzigd werken, jullie hoeven niets om te zetten. Gebruik voor nieuwe items https://picasi.app/mcp.

Aanverwante onderwerpen

MCP-tools — Overzicht Alle beschikbare MCP-tools met parameters.