Conectar ARES con Cursor (MCP): empresas

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → ARES Czech Company Register, instálalo sin clave, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

ARES Czech Company Register + Cursor

Datos de empresas checas de ARES, el registro de sujetos económicos del Ministerio de Finanzas, sin clave API: busca empresas por nombre o IČO, lee el registro básico, el extracto del registro comercial con propietarios y órgano estatutario, el registro estadístico, licencias comerciales, registros de quiebras y listas de códigos.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

(ninguna: datos públicos, sin clave API)

Paso 1 — Configura el conector

Datos públicos, sin clave: la configuración tarda menos de un minuto. El conector lee ARES (Administrativní registr ekonomických subjektů), el sistema de información pública del Ministerio de Finanzas checo que une los datos de los registros fuente checos: el Registro Público (comercial), el registro de la Oficina Estadística, el Registro de Licencias Comerciales, el Registro Básico de Personas, el registro de IVA, el Registro Central de Quiebras y otros. No se necesita cuenta, clave API ni inicio de sesión.

1. En la tienda de conectores, elige ARES Czech Company Register e instálalo. No hay nada que pegar y no hay paso de Autorizar con el Proveedor.
2. Verifícalo con ares_get_subject y el IČO 27074358: devuelve el nombre de la empresa, la sede registrada, la forma jurídica y los registros en los que aparece.

La nube y el autoalojamiento funcionan de la misma manera: no hay nada que configurar en ninguno de los dos.

Identificadores: el IČO (ID de empresa) tiene 8 dígitos; conserva los ceros a la izquierda (00006947). El número de IVA checo (DIČ) suele ser CZ más el IČO, por ejemplo CZ27074358. El número de expediente del tribunal de registro (spisová značka) es tribunal, sección e inserción, por ejemplo C 209831 en el Tribunal Municipal de Praga.

Por dónde empezar: ares_search_subjects encuentra una empresa por nombre comercial (narrowed by municipality or legal form) o por una lista de números IČO. ares_get_subject devuelve el resumen y seznamRegistraci, que indica en qué registros el sujeto está activo (AKTIVNI), histórico (HISTORICKY) o no presente (NEEXISTUJICI). Luego profundiza donde está presente: ares_get_commercial_register para propietarios, órgano estatutario, capital e historia (varias empresas a la vez con ares_search_commercial_register), ares_get_statistical_register para tamaño y sector, ares_get_trade_licences para oficios, ares_get_basic_register para la caja de datos y estado legal, ares_get_bankruptcy_records y ares_get_other_register_record. ares_search_codelists decodifica formas jurídicas, oficinas de impuestos y códigos NACE.

Lectura de los datos: los nombres de los campos están en checo, y la IA los traduce: obchodniJmeno nombre comercial, sidlo sede registrada, pravniForma forma jurídica (112 s.r.o., 121 a.s., 101 empresario individual), datumVzniku fecha de establecimiento, datumZaniku fecha de disolución. En el registro comercial, statutarniOrgany enumera los órganos estatutarios y sus miembros (por ejemplo jednatel, director general), spolecnici los socios con sus participaciones y zakladniKapital el capital registrado. Un ítem con una fecha de eliminación (datumVymazu) es historia, no actual. Cantidades como "10;00" utilizan un punto y coma como separador decimal.

Datos personales: los extractos del registro comercial nombran a personas naturales con sus fechas de nacimiento. Úsalos solo para fines comerciales legítimos.

Solo lectura: cada herramienta solo lee, por lo que no hay nada que confirmar y ninguna herramienta se apaga al instalar.

Límites: ARES es gratuito para cualquier uso, pero pide volúmenes razonables y puede bloquear una dirección que lo inunde. Los resultados de búsqueda están limitados: la IA pagina con start y count y estrecha los filtros. Para procesamiento masivo, utiliza los volúmenes de datos abiertos de ARES en lugar de la API. ARES toma sus datos de los registros fuente; el extracto legalmente vinculante es el que proviene del registro mismo, por ejemplo el Registro Público en or.justice.cz.

Errores comunes: NENALEZENO (HTTP 404) significa que el IČO no fue encontrado en ese registro. CHYBA_VSTUPU (400) significa entrada incorrecta o vacía: una búsqueda necesita al menos un filtro. OBECNA_CHYBA es un error general del lado de ARES.

El conector no cambia nada en los registros checos y no emite extractos oficiales.

Paso 2 — Instala el adaptador

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ñade 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 ARES Czech Company Register.

Herramientas disponibles

Ejemplos de indicaciones

• "Busca el IČO 27074358 y dime el nombre comercial, la sede registrada, la forma jurídica y en qué registros está activo."
• "¿Quiénes son los directores generales y socios de 27074358 según el registro comercial, y cuál es el capital registrado?"
• "¿Este proveedor tiene registros en el Registro Central de Quiebras?"
• "¿Qué licencias comerciales tiene el IČO 27074358 y cuáles siguen siendo válidas?"
• "Encuentra empresas s.r.o. llamadas Stavby en Brno y dame sus números IČO."

Preguntas frecuentes

¿Es un registro de ARES un extracto legalmente vinculante? No. ARES une los datos de los registros fuente para información. El extracto legalmente vinculante es el que proviene del registro mismo, por ejemplo el Registro Público en or.justice.cz.

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

Próximos pasos

• Página de inicio del conector
• Conectar a Claude