MCP Setup: configurar no Claude

MCP (Model Context Protocol) é o padrão da Anthropic pra IAs conversarem com sistemas externos. O Fala Cheese expõe servidor MCP em /api/mcp — seu Claude chama nosso motor direto.

Endpoint

https://app.falacheese.com.br/api/mcp

Autenticação: API key (mesma do REST). Veja REST API pra criar.

Setup no Claude Desktop (macOS)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fala-cheese": {
      "url": "https://app.falacheese.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer fc_live_..."
      }
    }
  }
}

Reinicia Claude Desktop. No canto inferior da conversa aparece ícone de ferramenta com "fala-cheese" listada.

Setup no Claude Desktop (Windows)

Mesmo JSON em %APPDATA%\Claude\claude_desktop_config.json.

Setup no Claude Code (CLI)

Em qualquer terminal:

claude mcp add fala-cheese \
  --url https://app.falacheese.com.br/api/mcp \
  --header "Authorization: Bearer fc_live_..."

Daqui pra frente, qualquer sessão claude no terminal tem as ferramentas Fala Cheese disponíveis. Verifica com /mcp dentro da sessão.

Setup no Claude.ai (web)

Em claude.ai, vai em Settings → Connectors, clica em Add custom connector:

Name: Fala Cheese
URL: https://app.falacheese.com.br/api/mcp
Auth: Bearer fc_live_...

Salva. Disponível em qualquer nova conversa.

Verificar conexão

Numa conversa nova com o Claude, pergunta:

"Quais ferramentas você tem disponíveis do Fala Cheese?"

O Claude deve listar list_accounts, create_post, get_calendar, list_comments, reply_comment. Veja Tools Reference pra detalhes.

Múltiplos ambientes

Você pode ter o Fala Cheese conectado ao mesmo tempo no Desktop + Code + Web. Cada um usa sua própria API key. Recomendado: uma key por ambiente pra você revogar individual se algo vazar.

Trocar de workspace via MCP

Hoje o MCP usa a workspace default da sua conta. Pra agir em workspace específica, passa workspaceId explicitamente no parâmetro create_post (ou outros que aceitam).

Roadmap: definir workspace ativa no nível da sessão MCP, pra não precisar passar a cada chamada.

Segurança

Chave fica em arquivo local (config.json) ou cookie do Claude.ai
Backup do config: NÃO commita no git público — adiciona em .gitignore
Revogar: /app/settings → API keys → três pontinhos → Revogar

Limitações conhecidas

MCP não suporta upload de mídia binária direto. Pra criar post com imagem, primeiro sobe a imagem via REST /api/v1/media, depois passa o mediaId retornado no create_post via MCP
Sem streaming de respostas — cada tool call é síncrono
Sem batch — pra criar 10 posts, são 10 chamadas separadas

Troubleshooting

"Connection failed" no Claude Desktop

Reinicia Desktop completo (não só Cmd+R)
Confere o JSON com cat ~/Library/Application Support/Claude/claude_desktop_config.json | jq — deve parsear sem erro
Testa a URL direto via curl com a key: curl -H "Authorization: Bearer fc_live_..." https://app.falacheese.com.br/api/mcp

"Tools not appearing"

Confere que fala-cheese está no array mcpServers (não dentro de outro objeto)
Reinicia Desktop após cada edit do config

"Unauthorized"

API key revogada ou expirada — gera nova em /app/settings