Instalação
Antes de tudo, gere um token pessoal: no painel da PicChat, abra o menu do seu perfil → Minha conta → Conectar ao Claude, dê um nome ao token e clique em gerar. Ele aparece uma vez só — copie na hora.
Tokens de integração (Configurações → Integrações) também funcionam no MCP e agem como o usuário que os criou.
Remoto
Servidor: https://mcp.picchat.io/mcp · transporte HTTP · token no header Authorization: Bearer <token>.
Claude Code
claude mcp add --transport http picchat https://mcp.picchat.io/mcp --header "Authorization: Bearer SEU_TOKEN"Confira com claude mcp list e pergunte algo como "qual é a minha conta na PicChat?".
claude.ai e o conector do Claude Desktop ainda não funcionam com o servidor remoto: eles só aceitam conectores com login OAuth, e o MCP da PicChat usa token no header. No Claude Desktop, use a instalação local abaixo.
Cursor e outros clientes
Qualquer cliente compatível com MCP por HTTP funciona. Exemplo de mcp.json:
{
"mcpServers": {
"picchat": {
"url": "https://mcp.picchat.io/mcp",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}Local (npx)
Roda o servidor na sua máquina via stdio. Precisa de Node.js 18+.
Claude Code
claude mcp add picchat -e PICCHAT_TOKEN=SEU_TOKEN -- npx -y picchat-mcpClaude Desktop
No claude_desktop_config.json:
{
"mcpServers": {
"picchat": {
"command": "npx",
"args": ["-y", "picchat-mcp"],
"env": { "PICCHAT_TOKEN": "SEU_TOKEN" }
}
}
}Para o time todo (Claude Code)
Um .mcp.json na raiz do repositório deixa o MCP disponível para quem abrir o projeto. Cada pessoa usa o próprio token pela variável de ambiente — não versione o token:
{
"mcpServers": {
"picchat": {
"command": "npx",
"args": ["-y", "picchat-mcp"],
"env": { "PICCHAT_TOKEN": "${PICCHAT_TOKEN}" }
}
}
}Variáveis do modo local
| Variável | Obrigatória | Descrição |
|---|---|---|
PICCHAT_TOKEN |
sim | Token pessoal ou de integração |
PICCHAT_API_URL |
não | Base da API. Padrão: https://api.picchat.com.br |
Testar a conexão
Peça ao Claude: "Qual é a minha conta na PicChat e o que eu posso consultar?". Ele vai chamar picchat_get_account e mostrar a conta, o seu usuário, o grupo de permissão e as consultas liberadas.