Conectar Picasi con Claude Code

De qué se trata

Configurarás Picasi como servidor MCP en Claude Code. A continuación, podrás preguntar directamente en el chat de Claude por las actualizaciones de tus competidores, gestionar fuentes u obtener informes, sin necesidad de abrir la aplicación de Picasi.

Lo que necesitas

Un token de la API de Picasi (instrucciones: Crear un token de la API)
La URL de MCP de vuestro espacio de trabajo (la encontraréis en Configuración → Conexiones de IA y tokens)

Opción A: Configurar a través de la CLI

Ten a mano el token y la URL

Abre Configuración → Conexiones de IA y tokens en Picasi y copia la URL de MCP (formato: https://picasi.app/mcp/t-xxxxxxxxxx).

Añadir el servidor MCP

Ejecuta el siguiente comando en un terminal:

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

Sustituye t-xxxxxxxxxx y DEIN_TOKEN por tus valores reales.

Probar la conexión

Inicia Claude Code y escribe:

¿Qué fuentes hay en mi espacio de trabajo de Picasi?

Claude responderá con datos reales si la conexión funciona.

Opción B: editar directamente `.mcp.json`

Si prefieres tener la configuración como un archivo en el proyecto:

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

Guarda este archivo como .mcp.json en la raíz de tu proyecto. Claude Code lo lee automáticamente.

Variables de entorno en lugar de texto sin cifrar

Para proyectos cuyo .mcp.json se encuentre en Git, nunca introduzcas el token en texto sin cifrar. Dos formas seguras de hacerlo:

1. Configuración global de Claude Code

En lugar de un .mcp.json específico para cada proyecto, configura el servidor una sola vez de forma global:

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

De este modo, el servidor estará disponible en todos los proyectos sin necesidad de incluir .mcp.json en el repositorio.

2. Variable de entorno en un archivo no confirmado

Para servidores específicos de cada proyecto: confirma .mcp.json en el repositorio, pero lee el token desde el entorno.

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

Establecer la variable PICASI_API_TOKEN en un archivo .env (en .gitignore) o directamente en el shell en el que se inicia Claude Code:

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code no lee la variable hasta que se inicia. Si se modifica el token, es necesario reiniciar Claude Code.

Varios espacios de trabajo

Si hay varios espacios de trabajo de Picasi (por ejemplo, una agencia con varios clientes), cree una entrada de servidor independiente para cada espacio de trabajo y asígnele un nombre único:

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

Claude Code ejecuta las herramientas de los servidores en espacios de nombres separados (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), para que no haya confusión.

Temas relacionados

Herramientas MCP — Resumen Todas las herramientas MCP disponibles con sus parámetros.