Ligar o Picasi ao Claude Code

Do que se trata

Configuras o Picasi como servidor MCP no Claude Code. Depois podes perguntar diretamente no chat do Claude pelos Updates dos vossos concorrentes, gerir fontes ou consultar relatórios — sem abrir a app Picasi.

O que precisas

Um token de API do Picasi (instruções: Criar token de API)
A URL do MCP (em Definições → Ligações de IA e tokens)

Opção A: Configurar via CLI

Ter token e URL à mão

Abre Definições → Ligações de IA e tokens no Picasi e copia a URL do MCP. É https://picasi.app/mcp e é a mesma para todos os Workspaces: qual deles o servidor mostra decide-o o token.

Adicionar servidor MCP

Executa o seguinte comando num terminal:

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

Substitui DEIN_TOKEN pelo teu token.

Testar a ligação

Inicia o Claude Code e escreve:

Que fontes existem no meu Workspace do Picasi?

O Claude responde com dados reais se a ligação estiver a funcionar.

Opção B: Editar diretamente o `.mcp.json`

Se preferires ter a configuração como ficheiro no projeto:

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

Guarda este ficheiro como .mcp.json na raiz do teu projeto. O Claude Code lê-o automaticamente.

Variáveis de ambiente em vez de texto simples

Para projetos cujo .mcp.json está no Git, nunca inserir o token em texto simples. Dois caminhos seguros:

1. Configuração global do Claude Code

Em vez de um .mcp.json específico do projeto, cria o servidor uma vez a nível global:

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

O servidor fica então disponível em todos os projetos, sem .mcp.json no repositório.

2. Variável de ambiente num ficheiro não commitado

Para servidores específicos do projeto: commitar o .mcp.json no repositório, mas ler o token a partir do ambiente.

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

Define a variável PICASI_API_TOKEN num ficheiro .env (no .gitignore) ou diretamente na shell onde o Claude Code arranca:

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

O Claude Code só lê a variável no arranque. Se o token for alterado, é preciso reiniciar o Claude Code.

Vários Workspaces

Com vários Workspaces do Picasi (p. ex., agência com vários clientes), cria uma entrada de servidor própria para cada Workspace e dá-lhe um nome inequívoco:

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

O endereço é o mesmo nas duas entradas, o Workspace está no token. O Claude Code executa as ferramentas dos servidores em namespaces separados (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources), para não haver confusão.

O endereço antigo com o código do Workspace

As configurações mais antigas trazem um endereço do tipo https://picasi.app/mcp/t-xxxxxxxxxx, com o código do Workspace no fim. Continua a funcionar sem alterações, não têm de mudar nada. Para entradas novas usem https://picasi.app/mcp.

Tópicos relacionados

Ferramentas MCP — Visão geral Todas as ferramentas MCP disponíveis com parâmetros.