Cuando quieres conectar Claude con una API externa vía MCP. Te da el diseño completo del server con tools y código inicial.
El prompt
Eres un developer que ha construido MCP servers (Model Context Protocol) para conectar Claude con APIs externas. Entiendes la especificación MCP y sabes que un buen server tiene tools atómicas, bien documentadas, con schemas claros.
Necesito diseñar un MCP server para [servicio/API]. Genera:
1. TOOLS: Lista de tools que el server debería exponer. Para cada una:
- Nombre (snake_case, verbo + sustantivo)
- Descripción (1 línea, clara para un LLM)
- Input schema (JSON Schema con tipos y descripciones)
- Output format
- Ejemplo de uso
2. RESOURCES: ¿Hay datos estáticos que el server debería exponer como resources? (documentación, schemas, configuración)
3. AUTENTICACIÓN: ¿Cómo se autentica con la API? ¿API key, OAuth, token? ¿Dónde se guarda la credencial?
4. ERROR HANDLING: ¿Qué errores puede devolver la API y cómo los traduce el server a mensajes útiles para Claude?
5. RATE LIMITING: ¿Tiene rate limits la API? ¿Cómo los gestiona el server?
6. CÓDIGO: Estructura del proyecto y código del server en TypeScript o Python (el que prefiera el developer).
API a integrar: [nombre, docs URL, endpoints principales]
Cómo usarlo
Modelo recomendado: Claude
Ejemplo de input
API: Circle.so (academia online). Endpoints principales: listar spaces, crear post, listar miembros, gestionar comentarios. Auth: API key en header.
Ejemplo de output
TOOLS:
1. list_spaces Desc: List all spaces in the Circle community Input: {community_id: string (required)} Output: Array of {id, name, member_count}
2. create_post Desc: Create a new post in a specific space Input: {space_id: string, title: string, body: string, status: 'draft'|'published'}
AUTH: API key vía env var CIRCLE_API_KEY. Header: Authorization: Token {key}
Contexto
Cómo diseñar un MCP server para conectar Claude con cualquier API
MCP (Model Context Protocol) es la forma estándar de conectar Claude con herramientas externas. En vez de pegar datos a mano en el chat, Claude llama directamente a tu API, procesa los resultados, y toma decisiones con ellos.
Este prompt genera el diseño completo de un MCP server: tools con input/output schemas, resources estáticos, autenticación, error handling, rate limiting, y código inicial del server.
La clave está en las tools. Cada tool debe ser atómica (hace una sola cosa), bien nombrada (verbo + sustantivo en snake_case), y con una descripción que un LLM pueda entender sin ambigüedad. Si la descripción dice 'manage posts', Claude no sabe si crear, editar o borrar. Si dice 'create a new post in a specific space', no hay duda.
Para empezar, identifica los 5-8 endpoints de tu API que más usas. Esos son tus primeras tools. Puedes añadir más después.