MCP no Claude Code

O Pico expõe as mesmas coisas da API como ferramentas MCP em https://app.usepico.digital/api/mcp (Streamable HTTP). Instalou, e o Claude Code passa a pesquisar o seu nicho, rascunhar peças, agendar e ler seus leads — conversando, com você no comando.

Instalar

Claude Code (um comando; a tela Conta → API e MCP mostra pronto com a sua chave):

claude mcp add --transport http pico https://app.usepico.digital/api/mcp \
  --header "Authorization: Bearer pico_sk_SUA_CHAVE"

Confira com claude mcp list — pico deve aparecer conectado. Na próxima conversa, as ferramentas pico_* estão disponíveis.

Por projeto (.mcp.json na raiz do repositório, sem a chave no arquivo — o Claude Code expande ${PICO_API_KEY} do ambiente):

{
  "mcpServers": {
    "pico": {
      "type": "http",
      "url": "https://app.usepico.digital/api/mcp",
      "headers": { "Authorization": "Bearer ${PICO_API_KEY}" }
    }
  }
}

Claude Desktop, Cursor e outros clientes sem header: mcp-remote faz a ponte.

{
  "mcpServers": {
    "pico": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.usepico.digital/api/mcp",
               "--header", "Authorization: Bearer ${PICO_API_KEY}"]
    }
  }
}

O que a chave deixa o Claude fazer

O servidor só lista as ferramentas que a chave alcança. Uma chave leitura+escrita mostra leitura, rascunho, agenda e tradução; sem gasto, pico_pesquisa_criar nem aparece; sem publicacao, pico_peca_publicar e pico_lead_responder nem aparecem. É a mesma regra da autenticação — decidida no servidor, não na descrição.

As ferramentas

Cada ferramenta é uma rota da referência — mesma entrada, mesma resposta, mesmos erros.

Como o Claude pede confirmação

As ferramentas que gastam ou agem na conta têm a instrução embutida na própria descrição: só mande confirmarGasto: true / confirmar: true depois de a pessoa dizer sim. Chamada sem o campo devolve o valor (ou o que vai acontecer) em vez de erro — o Claude mostra e pergunta. Três camadas, todas do lado do servidor ou do seu:

1. o escopo da chave (você escolheu ao criar);
2. o Claude Code pede permissão por chamada de ferramenta;
3. o servidor recusa sem o campo literal.

Uma conversa típica:

Você: pesquisa o nicho de moda casual feminina em SP. Claude: chamou pico_pesquisa_criar sem confirmação → "custa cerca de US$ 1,50 (coleta + inteligência por vídeo). Sigo?" Você: sim. Claude: chamou de novo com confirmarGasto: true → "rodando; consulto a cada instante e te aviso."

Do Instagram para a landing page

O Claude não abre o Instagram (o site pede login). Com o Pico conectado, ele não precisa:

Você: faz uma landing page de alta conversão para instagram.com/clinica.exemplo Claude: chamou pico_instagram_conta → nome, bio, WhatsApp da bio, os serviços pelas legendas e os 3 posts que mais renderam → escreve a página e baixa as imagens para o projeto (os links do Instagram vencem em dias).

Se a conta ainda não foi lida, a resposta é 404 com o próximo passo, e o Claude pergunta antes de usar pico_instagram_ler (cerca de US$ 0,003). Use com contas públicas, para o próprio negócio ou com a autorização dele.

Recursos e prompts

Além das ferramentas, o servidor entrega:

• Recursos (contexto que o Claude lê sem gastar chamada): pico://perfil (o seu perfil em Markdown), pico://docs/{guia} (estes guias), pico://pesquisa/{id}/resumo.
• Prompts (roteiros prontos): planejar_semana (lê hoje + pesquisa + perfil e propõe 7 peças), responder_lead (propõe a resposta no tom do perfil — não envia), revisar_peca.

Limites e erros

Os mesmos da API (limites): a classe da ferramenta é a da rota. Erro vira uma resposta de ferramenta com isError: true e o code da tabela — o Claude lê e explica.

Segurança

• Só chave. A sessão do app (cookie) não entra no MCP: sem Authorization: Bearer pico_sk_… a resposta é 401.
• A chave vai só no header; o servidor não mantém sessão (Streamable HTTP stateless).
• Proteção contra DNS rebinding ligada (allowedHosts = o host do Pico).
• Revogou a chave na tela? O pico para na próxima chamada.