Primeros pasos

# Servidor MCP

Conecta Claude, Cursor u otro asistente de programación con IA a tu cuenta para que lea la documentación y haga validaciones reales mientras construye tu integración.

El servidor MCP conecta un asistente de programación con IA (Claude, Cursor, VS Code y otros clientes MCP) a tu cuenta de MexCheck. Mientras escribe tu integración, el asistente puede leer esta documentación, hacer validaciones reales para ver las respuestas exactas y consultar tu plan y tu saldo.

Es una herramienta para construir la integración, no una parte de ella. En producción tu servidor llama al API REST con una llave API, como describe el resto de esta documentación.

## Cómo conectarse

Agrega esta URL a tu asistente como servidor MCP remoto:

URL

```text
https://mexcheck.com/mcp
```

Claude Code

```bash
claude mcp add --transport http mexcheck https://mexcheck.com/mcp
```

Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mexcheck": { "url": "https://mexcheck.com/mcp" }
  }
}
```

No hay llave API que pegar. La primera vez que el asistente usa el servidor abre tu navegador, inicias sesión y eliges como qué cuenta actúa: tu cuenta personal o una organización a la que perteneces. Cada conexión actúa como una sola cuenta. Para usar otra, conéctate de nuevo y elígela.

Listar las herramientas y leer la documentación funciona antes de iniciar sesión. El inicio de sesión empieza la primera vez que el asistente usa una herramienta que toca tu cuenta.

## Herramientas


| Herramienta | Qué hace |
| --- | --- |
| `rfc_validate`, `rfc_verify`, `rfc_profile`, `rfc_find_zip`, `rfc_sat_lists`, `cfdi_verify`, `csf_verify` | Los endpoints de RFC, CFDI y Constancia de Situación Fiscal, que responde el SAT. |
| `curp_lookup`, `curp_search` | Los endpoints de CURP, que responde RENAPO. |
| `ine_verify` | El endpoint de credencial para votar, que responde el INE. |
| `cfe_verify` | El endpoint de recibos de luz, respondido por CFE. |
| `geo_zip`, `geo_zip_search` | Los endpoints de códigos postales, respondidos desde el catálogo de Correos de México. |
| `list_docs`, `read_doc`, `get_openapi_operation` | Esta documentación en Markdown, agrupada por producto, y la definición OpenAPI de cada endpoint. |
| `get_account`, `list_plans` | El plan de la cuenta conectada, sus créditos usados, su saldo y lo que le cuesta cada validación. |
| `create_api_key` | Una llave API nueva para tu servidor, que se muestra una sola vez. Las llaves se listan y se revocan en tu panel. |
| `charge_saved_card` | Agrega saldo con cargo a la tarjeta guardada. Solo si lo permitiste al conectar, hasta tu límite diario. |
| `create_plan_checkout`, `create_balance_checkout`, `get_billing_portal_link` | Ligas a páginas de Stripe donde te suscribes, agregas saldo o administras la facturación. |


Cada herramienta de validación recibe los mismos campos que su endpoint REST y devuelve el mismo JSON. La entrega por webhook y /rfc/verify-batch solo están en el API REST, porque una herramienta tiene que responder dentro de la conversación.

## Facturación

Una validación hecha por MCP es una consulta real y cuesta los mismos créditos que la llamada REST, del plan y el saldo de la cuenta conectada. Las herramientas de documentación y de cuenta son gratis.

Fuera de eso, las herramientas de facturación solo devuelven una liga: no se cobra nada ni cambia ningún plan hasta que abres la liga y confirmas en la página de Stripe.

La única excepción la decides tú. Al conectar, puedes permitir que el asistente agregue saldo con cargo a la tarjeta guardada de la cuenta, hasta un límite diario que tú fijas ($100 USD si no lo cambias). Está desactivado a menos que marques la casilla, el límite se reinicia a la medianoche UTC, y puedes verlo y terminarlo en Apps conectadas.

## Organizaciones

Una conexión a una organización sigue tu rol en ella, igual que el panel. Los administradores y desarrolladores pueden hacer validaciones. Los administradores y los miembros de facturación pueden usar las herramientas de facturación. Un cambio de rol aplica desde la siguiente solicitud, y salir de la organización termina la conexión.

## Privacidad

Lo que devuelve una validación (nombres, CURP, datos fiscales) llega al asistente que conectaste y a la empresa que lo opera. Conecta asistentes a los que les confiarías esos datos.

## Cómo desconectarse

Abre [Llaves API](/dashboard/api-keys) en tu panel. Ahí aparecen las apps conectadas, cada una con un botón Desconectar que termina su acceso de inmediato.