Como Conectar o Forktastic ao Claude com MCP

Este passo a passo conecta sua biblioteca de receitas Forktastic ao Claude — Claude Desktop, Claude Code ou qualquer lugar que suporte MCP. Uma vez conectado, cada sessão do Claude tem acesso de leitura às suas receitas, livros de receitas e conteúdo compartilhado pela família. Você pode pedir ao Claude para planejar sua semana, encontrar receitas por ingrediente, gerar listas de compras em qualquer formato que você queira ou construir agentes que trabalhem com sua biblioteca.

Os pré-requisitos

• Forktastic Pro (o acesso ao MCP é restrito à assinatura Pro).
• Um cliente Claude que suporte MCP — Claude Desktop, Claude Code ou qualquer cliente compatível.
• Cinco minutos para a configuração.

Passo 1 — Emitir um Token de Acesso Pessoal

No Forktastic, vá para Configurações → Tokens de Acesso Pessoal → Novo Token. Dê a ele um rótulo ("Claude Desktop", "Claude Code", etc.) para que você saiba para qual cliente ele é. O token é mostrado uma vez — copie-o imediatamente. Passo a passo completo do PAT.

Passo 2 — Adicione o servidor ao seu cliente Claude

Para o Claude Desktop, abra o arquivo de configuração em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou o caminho equivalente em sua plataforma. Adicione uma entrada de servidor:

{
  "mcpServers": {
    "forktastic": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "MCP_URL": "https://mcp.forktastic.com/rpc",
        "MCP_TOKEN": "your-PAT-here"
      }
    }
  }
}

(A sintaxe exata da configuração pode evoluir com as atualizações do Claude Desktop — verifique a documentação atual do MCP do Claude Desktop se este trecho não carregar. O princípio é o mesmo: adicione o servidor MCP do Forktastic com seu PAT.)

Passo 3 — Reinicie o Claude

Saia do Claude completamente e reabra. As ferramentas Forktastic agora devem aparecer em sua paleta de ferramentas. Teste com uma pergunta simples: "Liste meus livros de receitas do Forktastic." Claude deve responder com sua lista de livros de receitas real.

As sete ferramentas que você agora tem

• search_recipes — pesquisa de texto completo em sua biblioteca
• get_recipe — buscar uma receita específica por ID
• list_cookbooks — seus livros de receitas
• search_cookbooks — pesquisar livros de receitas por nome
• get_cookbook — buscar um livro de receitas com suas receitas
• get_trending — receitas populares (em toda a plataforma, não apenas as suas)
• get_family — informações do seu grupo familiar (membros, livros de receitas compartilhados)

Referência completa da ferramenta e exemplos de consultas.

O que você pode fazer depois de conectado

Pergunte ao Claude:

• "Planeje uma semana de jantares da minha biblioteca usando o que está na minha geladeira. Eu tenho frango, brócolis e arroz."
• "Encontre as três receitas de cozimento lento que eu mais usei no último trimestre."
• "Gere uma lista de compras em Markdown para as receitas que eu planejei esta semana."
• "Encontre receitas na minha biblioteca que não tenham avisos de alérgenos para a alergia a nozes da minha sobrinha."

Cada um deles usa as ferramentas MCP para ler da sua biblioteca real, não dos dados de treinamento do Claude.

O que não pode fazer

O servidor MCP é somente leitura. Claude não pode criar, editar ou excluir receitas através dele. Esta é uma decisão de escopo deliberada — o acesso de gravação através de ferramentas agentic tem uma superfície de risco muito maior, e o modelo de confiança ainda não está pronto.

Solução de problemas

Se as ferramentas não aparecerem após a reinicialização, verifique:

• O PAT é válido (reemita se não tiver certeza).
• Você está no Forktastic Pro (PATs exigem Pro).
• O arquivo de configuração do Claude é JSON sintaticamente válido.
• Reinicie o Claude completamente, não apenas feche a janela.

Onde ir em seguida

Para a referência da ferramenta, passo a passo das 7 ferramentas MCP. Para Cursor em vez de Claude, configuração do Cursor. Para a visão geral do pilar MCP, guia do pilar MCP.