Documentación del servidor MCP — configuración y API JSON-RPC

Conecta Claude, Cursor o LM Studio al servidor MCP de Arttron: configuración JSON real, un ejemplo JSON-RPC tools/call y la referencia de la API REST.

Primeros pasos

1. Autenticación

Regístrate con email o GitHub → Recibe una clave API → Pégala en la configuración de tu cliente MCP

Envía la clave como token Bearer: Authorization: Bearer YOUR_API_KEY.

2. Obtén tu clave API

Inicia sesión en tu panel → Genera una nueva clave API → Copia la clave (se muestra solo una vez)

Conector de claude.ai (sin clave API)

Abre Settings → Connectors → Add custom connector, pega la URL del conector y aprueba OAuth. claude.ai se registra solo, así que no hace falta clave API.

MCP (JSON-RPC)

El endpoint MCP habla JSON-RPC 2.0 sobre Streamable HTTP. Apunta tu cliente a https://arttron.dev/api/mcp y autentícate con una clave Bearer: las doce herramientas se descubren automáticamente.

URL del conector

https://arttron.dev/api/mcp

Nota: /api/mcp/stream es la ruta SSE heredada que se mantiene solo para la API REST. No es un endpoint MCP, así que no funcionará en clientes MCP ni conectores — usa siempre https://arttron.dev/api/mcp.

Envía JSON-RPC 2.0 al endpoint MCP con la cabecera Authorization; el resultado de la herramienta llega en los bloques result.content.

Configuración del cliente MCP

{
  "mcpServers": {
    "arttron": {
      "url": "https://arttron.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Petición JSON-RPC (tools/call)

POST /api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dns_lookup",
    "arguments": { "domain": "example.com", "type": "MX" }
  }
}

API REST

Los endpoints REST de abajo son una API aparte, pensada para scripts: no son transportes MCP. La lista de herramientas es pública y llamar a una herramienta requiere una clave Bearer.

Petición REST

POST /api/mcp/tools/call
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "tool": "dns_lookup",
  "input": { "domain": "example.com", "type": "MX" }
}

Herramientas disponibles

Las doce herramientas las sirve el endpoint MCP https://arttron.dev/api/mcp. Usa la cabecera Authorization con tu clave API.

  • dns_lookup — Resolve DNS records
  • ip_lookup — Geolocate IP addresses
  • qr_generate — Generate QR codes
  • list_versions — List available versions
  • download_dev_server — Download server binary
  • proxy_image — Proxy external images

Límites de uso

Plan gratuito: 200 llamadas de herramientas al mes para claves MCP y 100 para claves API: esa cuota mensual es el límite principal.

Además de la cuota mensual, cada herramienta tiene un pequeño límite (por ejemplo, 20 consultas DNS/s, 30 geolocalizaciones IP/min, 15 proxies de imagen/s); todo se cuenta por clave API.

¿Necesitas ayuda?

Escríbenos a support@arttron.dev

Volver a MCP

Qué cubre la documentación de MCP

La documentación va de cero a la primera llamada a una herramienta. El primer paso es la autenticación: crea una cuenta gratuita y genera una clave API o, para claude.ai, registra la URL del conector y aprueba el aviso de OAuth, y así no hace falta clave. El segundo paso es la configuración del cliente: el bloque mcpServers de abajo apunta tu cliente al endpoint Streamable HTTP.

El resto de la página es el formato de intercambio. El endpoint MCP habla JSON-RPC 2.0; una petición tools/call nombra la herramienta y pasa sus argumentos, y el resultado llega en bloques content. Ejemplo: una petición tools/call para dns_lookup con {"domain":"example.com","type":"MX"} devuelve los registros MX de example.com. Una superficie REST aparte, cómoda para scripts, está documentada para quienes no hablan JSON-RPC.

Cómo conectar un cliente

  1. Inicia sesión y crea una clave API, o añade la URL del conector en claude.ai y aprueba OAuth.
  2. Pega el bloque mcpServers con el endpoint https://arttron.dev/api/mcp y tu clave Bearer.
  3. Reinicia el cliente; descubre las doce herramientas durante el handshake de MCP.
  4. Llama a una herramienta, por ejemplo dns_lookup, y lee el resultado en los bloques content.

Preguntas frecuentes sobre la documentación

¿Qué endpoint debo usar?

Para clientes MCP, siempre https://arttron.dev/api/mcp. La ruta /api/mcp/stream es la antigua SSE, mantenida solo para la API REST, y no es un endpoint MCP.

¿Necesito una clave API con claude.ai?

No. Añadir la URL del conector en Ajustes → Conectores → Añadir conector personalizado registra el cliente mediante OAuth 2.1, así que ahí no se necesita clave API.

¿Puedo llamar a las herramientas desde un script?

Sí. La superficie REST — tools/list es pública y tools/call necesita una clave Bearer — está documentada en la misma página para quienes no hablan JSON-RPC.