Associer Picasi à Claude Code

De quoi s’agit-il ?

Vous configurez Picasi en tant que serveur MCP dans Claude Code. Vous pouvez ensuite demander directement dans le chat Claude les Updates de vos concurrents, gérer vos sources ou consulter des rapports — sans avoir à ouvrir l’application Picasi.

Ce dont tu as besoin

Un jeton API Picasi (instructions : Créer un jeton API)
L’URL MCP (disponible sous Paramètres → Connexions IA et jetons)

Option A : configuration via la CLI

Prépare le jeton et l’URL

Ouvre Paramètres → Connexions IA et jetons dans Picasi et copiez l’URL MCP. Elle est https://picasi.app/mcp et identique pour tous les Workspaces : celui que le serveur montre est décidé par le jeton.

Ajouter un serveur MCP

Exécute la commande suivante dans un terminal :

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

Remplace DEIN_TOKEN par ton jeton.

Tester la connexion

Lance Claude Code et saisissez :

Quelles sont les sources présentes dans mon Workspace Picasi ?

Claude répondra avec des données réelles si la connexion fonctionne.

Option B : modifier directement `.mcp.json`

Si tu préfères avoir la configuration sous forme de fichier dans ton projet :

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

Enregistre ce fichier sous le nom .mcp.json à la racine de ton projet. Claude Code le lit automatiquement.

Variables d’environnement plutôt que texte clair

Pour les projets dont le fichier .mcp.json se trouve sur Git, n’enregistrez jamais le jeton en texte clair. Deux méthodes sécurisées :

1. Configuration globale de Claude Code

Au lieu d’un .mcp.json spécifique au projet, configurez le serveur une seule fois de manière globale :

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

Le serveur est alors disponible dans tous les projets, sans .mcp.json dans le dépôt.

2. Variable d’environnement dans un fichier non validé

Pour les serveurs spécifiques à un projet : valider .mcp.json dans le dépôt, mais lire le jeton à partir de l’environnement.

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

Définir la variable PICASI_API_TOKEN dans un fichier .env (dans .gitignore) ou directement dans le shell dans lequel Claude Code est lancé :

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code ne lit la variable qu’au démarrage. Si le jeton est modifié, Claude Code doit être redémarré.

Workspaces multiples

En cas de Workspaces Picasi multiples (par exemple, une agence avec plusieurs clients), créer une entrée de serveur distincte pour chaque Workspace et lui attribuer un nom unique :

{
  "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}" }
    }
  }
}

L’adresse est la même dans les deux entrées, le Workspace se trouve dans le jeton. Claude Code exécute les outils des serveurs dans des espaces de noms distincts (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), afin d’éviter toute confusion.

L’ancienne adresse avec le code du Workspace

Les anciennes configurations portent une adresse de la forme https://picasi.app/mcp/t-xxxxxxxxxx, avec le code du Workspace à la fin. Elle continue de fonctionner telle quelle, vous n’avez rien à changer. Pour les nouvelles entrées, utilisez https://picasi.app/mcp.

Sujets connexes

Outils MCP — Présentation générale Tous les outils MCP disponibles avec leurs paramètres.