> ## Content Index
> Fetch the complete content index at: https://www.digitalbrain.news/llms.txt
> Use this file to discover other available public pages before exploring further.

# Prompt para diseñar un MCP server personalizado
- URL: https://www.digitalbrain.news/prompts/prompt-disenar-mcp-server-personalizado/
- Published: 2026-06-16T10:15:00.000Z
- Updated: 2026-09-03T09:05:10.000Z
- Description: 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.
- Author: Ramón Pérez Coronado
- Tags: #prompts, mcp, claude, desarrollo

Cuando quieres conectar [Claude](https://www.digitalbrain.news/guias/que-es-claude-ia/) con una API externa vía [MCP](https://www.digitalbrain.news/guias/que-es-un-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](https://www.digitalbrain.news/guias/que-es-un-token-en-ia/) {key}

## Contexto

Cómo diseñar un [MCP server](https://www.digitalbrain.news/guias/que-es-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](https://www.digitalbrain.news/guias/que-es-un-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](https://www.digitalbrain.news/guias/que-es-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.

Fuente original: [digitalbrain.email](https://digitalbrain.email/?ref=digitalbrain.news)

---

**Relacionado**

[![Cómo conectar Gmail y Google Sheets con Claude por MCP](https://storage.ghost.io/c/6d/e3/6de31f63-d0a8-45df-9c6a-481016520347/content/images/size/w300/2026/07/mcp-gmail-sheets-claude.png)Cómo conectar Gmail y Google Sheets con Claude por MCP](https://www.digitalbrain.news/guias/mcp-gmail-sheets-claude/)[![Anthropic lanza Claude Opus 5: iguala a Fable 5 en codigo a mitad de precio](https://storage.ghost.io/c/6d/e3/6de31f63-d0a8-45df-9c6a-481016520347/content/images/size/w300/2026/07/anthropic-claude-opus-5-lanzamiento.png)Anthropic lanza Claude Opus 5: iguala a Fable 5 en codigo a mitad de precio](https://www.digitalbrain.news/noticias/anthropic-claude-opus-5-lanzamiento/)[![Claude Code estrena navegador propio en el escritorio para leer webs sin abrir Chrome](https://storage.ghost.io/c/6d/e3/6de31f63-d0a8-45df-9c6a-481016520347/content/images/size/w300/2026/07/claude-code-navegador-escritorio.jpg)Claude Code estrena navegador propio en el escritorio para leer webs sin abrir Chrome](https://www.digitalbrain.news/noticias/claude-code-navegador-escritorio/)