Conectar ARES con Microsoft Copilot (MCP)

💡 ¿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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de ARES Czech Company Register.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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.

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Próximos pasos

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