07 — MCP Servers

Un servidor puede declarar el comportamiento de cada tool. Permite que Claude Code muestre advertencias y pida confirmación automáticamente, sin lógica custom. A

• readOnly — solo lee datos, nunca modifica
• destructive — modifica datos irreversiblemente
• requiresConfirmation — el cliente debe pedir aprobación humana antes de ejecutar

{
  "name": "delete_records",
  "description": "Elimina registros de la base de datos",
  "annotations": {
    "destructive": true,
    "requiresConfirmation": true
  }
}

Stripe B — Stripe Engineering Blog

Stripe construyó un servidor MCP que expone su documentación técnica interna como resources. Sus 1,370+ ingenieros que usan Claude Code acceden a documentación actualizada directamente en el terminal — sin cambiar de herramienta ni salir del contexto de trabajo.

El resultado: Claude escribe código conforme a los estándares reales internos de Stripe, no a documentación pública genérica. La calidad del código generado es significativamente más consistente con las convenciones del equipo.

Recomendado 2025+ La librería mcp maneja JSON-RPC, handshake, serialización automáticamente.

# pip install mcp
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent
import requests, os, asyncio

server = Server("crm-mcp")

@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="buscar_cliente",
            # La descripción es crítica: Claude la lee para decidir cuándo usar la tool
            description="Busca cliente en el CRM por email o ID. Retorna nombre, plan activo, fecha de alta y últimas 5 transacciones. Usar cuando el usuario pregunta por información de un cliente específico.",
            inputSchema={
                "type": "object",
                "properties": {
                    "query": {"type": "string", "description": "Email o ID del cliente"},
                    "campo": {"type": "string", "enum": ["email", "id"]}
                },
                "required": ["query", "campo"]
            }
        )
    ]

@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "buscar_cliente":
        result = requests.get(
            "https://api.mi-crm.com/v1/customers",
            params=arguments,
            headers={"Authorization": f"Bearer {os.environ['CRM_API_KEY']}"}
        ).json()
        return [TextContent(type="text", text=str(result))]

async def main():
    async with stdio_server() as (read, write):
        await server.run(read, write, server.create_initialization_options())

asyncio.run(main())

// .mcp.json — en la raíz del proyecto (va en git)
{
  "mcpServers": {
    "crm-local": {
      "command": "python",
      "args": ["servidores/crm/servidor.py"],
      "env": {
        "CRM_API_KEY": "${CRM_API_KEY}"  // ← variable del sistema, NUNCA el valor real
      }
    },
    "github-oficial": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" }
    },
    "slack-remoto": {
      "type": "http",
      "url": "https://mcp.slack.com/api/v1",
      "headers": { "Authorization": "Bearer ${SLACK_BOT_TOKEN}" }
    }
  }
}

⚠ Nunca hardcodear tokens en .mcp.json. El archivo va en git — si tiene un token real, ese token es público.

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=4096,
    mcp_servers=[{
        "type": "url",
        "url": "https://mcp.github.com",
        "name": "github",
        "authorization_token": "tu_github_token"
    }],
    messages=[{"role": "user", "content": "Revisa los últimos 5 PRs abiertos"}],
    betas=["mcp-client-2025-04-04"]
)

Limitaciones: Solo call_tool. No soporta resources ni prompts. Requiere servidor HTTP público. A

# Lanzar MCP Inspector con tu servidor
npx @modelcontextprotocol/inspector python servidor.py

# Ver estado de todos los servidores en Claude Code
/mcp
# Estados: connected | disconnected | pending | error | needs-auth

# Logs detallados incluyendo tráfico JSON-RPC
claude --debug

export MCP_TIMEOUT=60000            # ms — para servidores lentos al arrancar
export MAX_MCP_OUTPUT_TOKENS=100000  # para respuestas muy grandes