Servidor MCP

Qué es

El servidor MCP expone las APIs de Datos Non Stop como herramientas que tu asistente puede llamar por sí solo cuando las necesita: le pides «valida este RFC» y él elige la herramienta, manda los datos y te responde. El transporte es HTTP (Streamable) sobre JSON-RPC 2.0.

Cada consulta se cobra y se valida igual que en la API REST: mismos tokens, mismas validaciones y los mismos datos de respuesta. Está incluido en todos los planes.

URL y entornos

Hay una sola URL para producción y sandbox. El entorno no lo decide la URL sino la credencial con la que te conectas: el token MCP que configuras, o lo que eliges al autorizar con inicio de sesión.

Para cambiar de entorno se cambia la credencial: con un token MCP, configura uno del otro entorno; si te conectaste con inicio de sesión, desconecta la aplicación y vuelve a conectarla eligiendo el otro entorno. Para que nunca haya duda de con qué datos estás trabajando:

• Cada respuesta de herramienta empieza con "entorno": "produccion" o "entorno": "sandbox".
• La herramienta entorno_actual dice en qué entorno está la conexión, sin costo. Pregúntale a tu asistente «¿en qué entorno estás?».

{
  "entorno": "sandbox",
  "descripcion": "Las consultas responden con datos de prueba y no cuestan tokens. Sólo responden los valores de prueba documentados. Para cambiar de entorno hay que cambiar la credencial: si la conexión usa un token MCP, configura un token del otro entorno; si se conectó con inicio de sesión (como en claude.ai), desconecta la aplicación y vuelve a conectarla eligiendo el otro entorno."
}

Sandbox

Funciona igual que la sandbox de la API: cada herramienta responde los casos de prueba documentados en la página de su API. Los ejemplos que el asistente ve en cada herramienta son justamente esos valores, así que «valida la CURP de ejemplo» funciona sin que tengas que buscarlos. Un valor sin respuesta de prueba devuelve un error que te lo indica.

Autenticación

Token MCP

Genéralo en la sección MCP Tokens del dashboard: ponle un nombre (por ejemplo «Claude Code en mi laptop»), elige su vigencia, de máximo 90 días, y su entorno. El token se muestra una sola vez: cópialo antes de salir de la página. Puedes revocarlo cuando quieras desde la misma sección.

Authorization: Bearer dnstp_mcp_live_…

Inicio de sesión (OAuth)

El cliente te manda al dashboard de Datos Non Stop. Inicias sesión con tu cuenta, eliges el entorno y autorizas; no tienes que copiar ningún token.

• Sandbox siempre se puede elegir. Producción aparece solo si tu cuenta tiene un plan activo o la prueba vigente, con el aviso de que esas consultas consumen tokens de tu saldo.
• La sesión se renueva sola mientras la uses. Si pasa sin uso 30 días en sandbox, o 7 en producción, el cliente te pide autorizar otra vez.
• Las aplicaciones que conectes así aparecen en MCP Tokens, en «Aplicaciones conectadas». Desde ahí las desconectas; pierden el acceso en menos de un minuto.

Claude (claude.ai)

• En claude.ai, ve a Configuración → Conectores → Agregar conector personalizado.
• Pega la URL https://mcp.datosnonstop.com/mcp y deja vacíos los campos de OAuth.
• Al conectar se abre el dashboard de Datos Non Stop: inicia sesión, elige Sandbox o Producción y autoriza.

Claude Code

Con inicio de sesión: registra el servidor sin token. Después, dentro de Claude Code, escribe /mcp, elige datos-non-stop y Authenticate.

claude mcp add --transport http datos-non-stop \
  https://mcp.datosnonstop.com/mcp

Con token MCP: sustituye TU_TOKEN_MCP por el token que generaste.

claude mcp add --transport http datos-non-stop \
  https://mcp.datosnonstop.com/mcp \
  --header "Authorization: Bearer TU_TOKEN_MCP"

Cursor

Agrega el servidor al bloque mcpServers de ~/.cursor/mcp.json y reinicia Cursor.

{
  "mcpServers": {
    "datos-non-stop": {
      "url": "https://mcp.datosnonstop.com/mcp",
      "headers": { "Authorization": "Bearer TU_TOKEN_MCP" }
    }
  }
}

Claude Desktop

Igual que en claude.ai: Ajustes → Conectores → Agregar conector personalizado, pega la URL del servidor MCP e inicia sesión. Sin token, sin archivos y sin instalar nada. Si ya lo agregaste en claude.ai, aparece solo en Claude Desktop y en el celular.

Planes y costo

El servidor MCP está incluido en todos los planes y en el periodo de prueba. Necesitas una cuenta con plan activo o prueba vigente, también para usar un token sandbox. Compara los planes en Precios.

• Cada herramienta cuesta lo mismo que su API y descuenta del mismo saldo de tokens. El costo aparece en la tabla de herramientas y en la descripción que lee el asistente, para que no gaste de más.
• En sandbox las consultas no cuestan tokens.
• Con inicio de sesión, elegir Producción requiere un plan activo o la prueba vigente.
• entorno_actual no cuesta tokens.
• Una consulta con parámetros inválidos no se cobra, y los tokens de una consulta que falla en la fuente oficial se reembolsan.

Errores

Los problemas de autenticación cortan la conexión con un código HTTP. Los de una consulta llegan como resultado de la herramienta marcado con isError: un JSON con entorno, error (qué hacer), http_status y detalle (la misma lista de errores que responde la API REST).

{
  "entorno": "produccion",
  "error": "Los parámetros no son válidos; corrígelos y vuelve a intentar",
  "http_status": 400,
  "detalle": [{
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "curp"
  }]
}

Herramientas

Una herramienta por API, con los mismos parámetros que la API REST, más entorno_actual. Da clic en una para ver sus parámetros, respuestas y valores de prueba.

APIs que no están en el MCP

Siguen disponibles en la API REST: PDF CURP por CURP (devuelve un PDF), PDF CURP por Datos Generales (devuelve un PDF), OCR Credencial de elector (recibe imágenes), Datos del empleo actual (es asíncrona), Comprobante Electrónico de Pago (CEP) + PDF (devuelve un PDF), Validación de cuenta bancaria (es asíncrona), Constancia de Situación Fiscal (pide la CIEC del contribuyente), Opinión de Cumplimiento (es asíncrona).

Ejemplo

Lo que viaja por el protocolo

Tu cliente MCP arma esto solo; lo mostramos por si integras un agente propio. El resultado llega como texto en content y como objeto en structuredContent; este es su contenido:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sepomex_codigo_postal",
    "arguments": { "codigoPostal": "06700" }
  }
}

{
  "entorno": "produccion",
  "resultado": {
    "status": "found",
    "codigoPostal": "06700",
    "asentamientos": [{
      "asentamiento": "Roma Norte",
      "delegacionMunicipio": "Cuauhtémoc",
      "estado": "Ciudad de México",
      …
    }]
  }
}