Conectar Openapi.com con Cursor (MCP)

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Openapi.com Company, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Openapi.com Company + Cursor

Datos de empresas italianas e internacionales de Openapi.com por número de IVA o código fiscal: perfil de empresa en tres niveles, PEC, código SDI, dirección, socios, stakeholders, titulares reales, comprobaciones de cese y de grupo de IVA, administraciones públicas, split payment, búsqueda de empresas, comprobaciones VIES de la UE y consultas en todo el mundo. Solo lectura; Openapi.com cobra cada llamada por separado.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

OPENAPI_COMPANY_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos minutos. Necesitas una cuenta de Openapi.com en console.openapi.com con saldo en su wallet o una suscripción a la Company API, y un token con los scopes de Company.

1. Inicia sesión en console.openapi.com y recarga saldo o suscríbete a la Company API.
2. Crea un token con los scopes de Company que necesites, en la sección Tokens de la consola o con la OAuth API. Un scope nombra el endpoint, por ejemplo GET:company.openapi.com/IT-advanced para openapi_company_it_advanced. Un token puede llevar varios scopes y vale hasta un año.
3. Copia el token en OPENAPI_COMPANY_TOKEN: solo el token, sin Bearer. El conector lo envía como Authorization: Bearer ....
4. Instala el conector. Para comprobar la conexión, consulta con openapi_company_it_start un número de IVA que conozcas; esa llamada también se cobra.

Cada llamada se cobra: Openapi.com carga cada petición a tu cuenta, del saldo del wallet o de tu suscripción, al precio por endpoint que muestra console.openapi.com. Ninguna herramienta es gratuita. openapi_company_it_full es la llamada más cara de la API; openapi_company_it_search se cobra según el número de resultados y el enriquecimiento de datos que pidas. La IA elige la herramienta más barata que responde (openapi_company_it_start u openapi_company_it_name antes de openapi_company_it_advanced, openapi_company_it_advanced antes de openapi_company_it_full), no repite una consulta cuya respuesta ya tiene y lanza una búsqueda primero con dryRun 1: eso devuelve el número de resultados y el precio, que la IA te dice antes de la búsqueda real.

Los scopes deciden qué funciona: una llamada a un endpoint para el que el token no tiene scope responde 403. En ese caso crea un token con los scopes GET:company.openapi.com que necesites.

Producción, o el sandbox para probar: el conector llama a producción en https://company.openapi.com. Openapi.com también tiene un sandbox en https://test.company.openapi.com, con sus propios tokens de sandbox y una lista fija de empresas de prueba. Para probarlo, cambia la base URL del conector a la dirección del sandbox y usa un token de sandbox. Un token de sandbox en producción responde 401.

Cloud y self-hosted funcionan igual: el token es la única credencial, y el conector llama a la misma dirección de Openapi.com en ambos casos.

Qué países: Italia en profundidad, a partir de la Cámara de Comercio, la Agencia Tributaria italiana (Agenzia delle Entrate) y el índice IPA de administraciones públicas. Para otros países de la UE, openapi_company_eu_vies_check comprueba un número de IVA en VIES y openapi_company_eu_start devuelve datos básicos para los prefijos AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI y SK. openapi_company_ww_start y openapi_company_ww_advanced cubren empresas de cualquier país, con datos avanzados donde las fuentes de ese país los ofrecen. Los endpoints de Openapi.com específicos de FR, DE, ES, PT, GB, BE, AT, CH y PL no están incluidos: las herramientas mundiales los sustituyen.

Identificadores: un número de IVA italiano (partita IVA) tiene 11 dígitos (12485671007), el código fiscal (codice fiscale) de una sociedad suele ser los mismos 11 dígitos y el de un autónomo tiene 16 caracteres. Las respuestas traen además un id de Openapi que la mayoría de herramientas italianas aceptan en su lugar. openapi_company_eu_vies_check recibe el código de país aparte (EL para Grecia), openapi_company_eu_start como prefijo (DE123456789), y las herramientas mundiales reciben un código de país ISO de dos letras junto con un número de IVA, código fiscal, número de registro o id de Openapi.

Búsqueda de empresas: openapi_company_it_search filtra por nombre (al menos 3 caracteres, * como comodín), provincia, municipio, código ATECO, forma jurídica (códigos de openapi_company_it_legal_forms), estado en la Cámara de Comercio, facturación, empleados, socio, PEC, código SDI o un radio alrededor de un punto. Sin dataEnrichment devuelve solo ids; con dataEnrichment, datos de empresa cobrados por resultado. Como máximo 1000 resultados por llamada; se pagina con skip y limit.

Fuentes lentas: cuando los registros van lentos, una llamada pesada como openapi_company_it_full u openapi_company_it_stakeholders responde a los 30 segundos con un id de petición y el estado PENDING. La IA llama entonces a openapi_company_check_request con ese id un poco más tarde, en lugar de pagar otra vez la consulta.

No incluido: las variantes POST asíncronas con callbacks, los paquetes AML y de marketing y la monitorización de cambios (/monitor).

Errores frecuentes: una llamada fallida trae success: false, un código error y un message. 401 significa que el token falta, es incorrecto o ha caducado, o que es un token de sandbox usado en producción. 402 significa que la cuenta no tiene saldo para esa llamada: recarga en console.openapi.com. 403 significa que al token le falta el scope de ese endpoint. 404 significa que no se encontró ninguna empresa, 406 un número de IVA o código fiscal con formato incorrecto. 429 significa demasiadas peticiones, o que el registro VIES nacional está ocupado: espera un momento y vuelve a intentarlo.

Qué lee: de las empresas italianas, nombre, número de IVA, código fiscal, dirección y estado de actividad; código ATECO, forma jurídica, número REA, capital social, facturación y empleados de los últimos balances, y fechas de alta y de cese; el expediente completo con administradores y más de 400 partidas de balance; la PEC con su historial y el código SDI para la factura electrónica; socios con más del 10 por ciento, stakeholders, las sociedades en las que participa y los titulares reales; si un número de IVA ha cesado, si una empresa pertenece a un grupo de IVA y si está en las listas de split payment; administraciones públicas con sus oficinas IPA y códigos SDI; los códigos de forma jurídica. De otros países: la validez en VIES con nombre y dirección, y datos de empresa básicos o avanzados en todo el mundo.

Solo lectura: todas las herramientas solo leen. No se escribe nada en Openapi.com ni en ningún registro, así que ninguna herramienta está desactivada al instalar; aun así, cada llamada se cobra.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Openapi.com Company.

Herramientas disponibles

Ejemplos de prompts

• "Comprueba el número de IVA 12485671007 antes de facturarle: razón social, si sigue activa, código SDI y PEC."
• "¿Quiénes son los socios y los titulares reales de la empresa con número de IVA 12485671007?"
• "Antes de facturar a este organismo público, comprueba si está en las listas de split payment y dame los códigos SDI de sus oficinas."
• "¿Cuántas empresas activas con código ATECO 62.01.00 hay en la provincia de Milán? Dime el precio antes de lanzar la búsqueda."
• "¿Es válido en VIES el número de IVA alemán DE123456789, y qué razón social tiene registrada?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude