Cómo conectar Checko a Microsoft Copilot vía MCP

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

Checko + Microsoft Copilot

Checko, due diligence de empresas y empresarios individuales rusos (EGRUL, EGRIP): datos de la empresa, directivos y fundadores, contactos, estados financieros, puntuación de fiabilidad, casos de arbitraje, procedimientos de ejecución, contratos de compras públicas, avisos de Fedresurs y de quiebra, inspecciones, bancos y búsqueda. Solo lectura.

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:

CHECKO_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Checko; la clave de API viene con ella.

1. Regístrate en https://checko.ru y abre tu área personal (Личный кабинет). La clave de API aparece ahí justo después del registro.
2. Pégala en CHECKO_API_KEY. El conector la envía como parámetro de consulta key.
3. Instala el conector y ejecuta checko_get_bank: la comprobación de instalación lee Sberbank (BIC 044525225) y muestra que la clave funciona.

Identificadores: un INN tiene 10 dígitos para una organización y 12 para un empresario individual o una persona física; un OGRN tiene 13 dígitos (organización) y un OGRNIP 15 (empresario). La mayoría de herramientas aceptan inn u ogrn, y basta con uno de los dos. Una sucursal comparte el INN de su organización matriz, así que lo que se devuelve es la matriz.

Qué lee: organizaciones del EGRUL y empresarios del EGRIP con estado, registro, domicilio legal, códigos de actividad OKVED, directivos, fundadores y sus participaciones, empresas vinculadas, licencias, sucursales, contactos, impuestos y deudas fiscales, inscripción en el registro de pymes, factores de riesgo y sanciones; los vínculos empresariales de una persona física por su INN personal; estados financieros por código de línea; una evaluación de fiabilidad con factores positivos y negativos; el historial de cambios en los registros; casos ante los tribunales de arbitraje; procedimientos de ejecución del FSSP; contratos de compras públicas según 44-FZ, 94-FZ y 223-FZ; avisos de Fedresurs y avisos de quiebra del EFRSB; inspecciones estatales; y bancos rusos por BIC del directorio del Banco de Rusia.

Cómo lo usa la IA: para encontrar una empresa busca con checko_search (un nombre de al menos 4 caracteres, o un directivo, fundador, teléfono, e-mail, código OKVED o fecha de registro) y después lee el resultado con checko_get_company por el INN. Para la due diligence de una contraparte combina checko_get_company, checko_get_reliability, checko_get_finances (los ingresos son la línea 2110 y el beneficio neto la línea 2400), checko_list_legal_cases con el rol de demandado, checko_list_enforcements, checko_list_bankruptcy_messages, checko_list_fedresurs_messages y checko_list_inspections. Para compras públicas filtra checko_list_contracts por law 44, 94 o 223 y por role cliente (customer) o proveedor (supplier).

Solo lectura: las 14 herramientas solo leen. No se presenta ni se cambia nada, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Paginación: las herramientas de listado devuelven hasta 100 filas por página (limit, page) junto con el total. Cada respuesta incluye meta con el estado, el número de peticiones de hoy y el saldo de la cuenta en rublos.

Costes y límites: las primeras 100 peticiones al día son gratuitas en todos los planes; después, cada petición correcta (HTTP 200) se cobra al precio del plan, de 0,10 a 0,15 rublos, y los errores son gratuitos. El límite técnico es de 32 peticiones por segundo por dirección IP. La IA prefiere una llamada concreta a muchas llamadas amplias.

Errores comunes: 401 con meta.message significa una clave ausente o no válida. 402, o un mensaje sobre el saldo, significa que la cuota diaria gratuita se ha agotado y el saldo está vacío. 404 significa que no se encontró nada para ese INN u OGRN. Las respuestas de error llevan meta.status error y el motivo en meta.message, en ruso.

El conector no cubre empresas de Bielorrusia, los datos brutos del EGRUL ni los conjuntos de datos masivos de Checko.

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 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 Checko.
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 prompts

• "Comprueba la contraparte con INN 7707083893: estado, director, fundadores, deudas fiscales y factores de riesgo."
• "¿Qué fiabilidad tiene la empresa con OGRN 1027700132195? Muéstrame su puntuación de fiabilidad, ingresos y beneficio neto de los últimos tres años."
• "Enumera los casos de arbitraje en los que esta empresa es demandada y los procedimientos de ejecución abiertos contra ella."
• "¿Qué contratos públicos según 44-FZ ha ganado este proveedor este año, y por qué importes?"
• "¿Qué otras empresas dirige el director de la INN 7707083893, o en cuáles participa?"

FAQ

¿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.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse