Cómo conectar Forktastic a Claude con MCP

Este tutorial conecta tu biblioteca de recetas de Forktastic a Claude: Claude Desktop, Claude Code o cualquier lugar que admita MCP. Una vez conectado, cada sesión de Claude tiene acceso de lectura a tus recetas, libros de cocina y contenido compartido familiarmente. Puedes pedirle a Claude que planifique tu semana, encuentre recetas por ingrediente, genere listas de compras en el formato que desees o cree agentes que trabajen con tu biblioteca.

Los requisitos previos

• Forktastic Pro (el acceso a MCP está limitado a la suscripción Pro).
• Un cliente de Claude que admita MCP: Claude Desktop, Claude Code o cualquier cliente compatible.
• Cinco minutos para la configuración.

Paso 1: emite un token de acceso personal

En Forktastic, ve a Configuración → Tokens de acceso personal → Nuevo token. Dale una etiqueta ("Claude Desktop", "Claude Code", etc.) para que sepas para qué cliente es. El token se muestra una vez: cópialo inmediatamente. Tutorial completo de PAT.

Paso 2: agrega el servidor a tu cliente de Claude

Para Claude Desktop, abre el archivo de configuración en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o la ruta equivalente en tu plataforma. Agrega una 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"
      }
    }
  }
}

(La sintaxis de configuración exacta puede evolucionar con las actualizaciones de Claude Desktop; consulta la documentación actual de MCP de Claude Desktop si este fragmento no se carga. El principio es el mismo: agrega el servidor MCP de Forktastic con tu PAT).

Paso 3: reinicia Claude

Cierra Claude por completo y vuelve a abrirlo. Las herramientas de Forktastic ahora deberían aparecer en tu paleta de herramientas. Prueba con una pregunta simple: "Enumera mis libros de cocina de Forktastic". Claude debería responder con tu lista de libros de cocina real.

Las siete herramientas que ahora tienes

• search_recipes: búsqueda de texto completo en tu biblioteca
• get_recipe: obtén una receta específica por ID
• list_cookbooks: tus libros de cocina
• search_cookbooks: busca libros de cocina por nombre
• get_cookbook: obtén un libro de cocina con sus recetas
• get_trending: recetas populares (en toda la plataforma, no solo las tuyas)
• get_family: la información de tu grupo familiar (miembros, libros de cocina compartidos)

Referencia completa de herramientas y consultas de ejemplo.

Qué puedes hacer una vez que esté conectado

Pregúntale a Claude:

• "Planifica una semana de cenas de mi biblioteca usando lo que tengo en mi refrigerador. Tengo pollo, brócoli y arroz".
• "Encuentra las tres recetas de cocción lenta que más he usado en el último trimestre".
• "Genera una lista de compras de Markdown para las recetas que tengo planeadas esta semana".
• "Encuentra recetas en mi biblioteca que no tengan advertencias de alérgenos para la alergia a las nueces de mi sobrina".

Cada uno de estos usa las herramientas MCP para leer de tu biblioteca real, no de los datos de entrenamiento de Claude.

Lo que no puede hacer

El servidor MCP es de solo lectura. Claude no puede crear, editar ni eliminar recetas a través de él. Esta es una decisión de alcance deliberada: el acceso de escritura a través de herramientas de agentes tiene una superficie de riesgo mucho mayor y el modelo de confianza aún no está listo.

Solución de problemas

Si las herramientas no aparecen después de reiniciar, verifica:

• El PAT es válido (vuelve a emitirlo si no estás seguro).
• Estás en Forktastic Pro (los PAT requieren Pro).
• El archivo de configuración de Claude es JSON sintácticamente válido.
• Reinicia Claude por completo, no solo cierres la ventana.

A dónde ir después

Para la referencia de la herramienta, tutorial de 7 herramientas MCP. Para Cursor en lugar de Claude, configuración de Cursor. Para la descripción general del pilar MCP, guía del pilar MCP.