Pular para o conteúdo
Picasi Picasi Documentação Picasi
Abrir app

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 do vosso Workspace (em Settings → Ligações de IA e tokens)

Opção A: Configurar via CLI

  1. Ter token e URL à mão

    Abre Settings → Ligações de IA e tokens no Picasi e copia a URL do MCP (formato: https://picasi.app/mcp/t-xxxxxxxxxx).

  2. Adicionar servidor MCP

    Executa o seguinte comando num terminal:

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

    Substitui t-xxxxxxxxxx e DEIN_TOKEN pelos teus valores reais.

  3. 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/t-xxxxxxxxxx",
      "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:

Terminal window
claude mcp add picasi \
  --scope user \
  --transport http \
  --url https://picasi.app/mcp/t-xxxxxxxxxx \
  --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/t-xxxxxxxxxx",
      "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:

Terminal window
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/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}" }
    }
  }
}

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.

Tópicos relacionados

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