La información empresarial en Colombia suele estar dispersa y desconectada. Hoy simplificamos el acceso con el lanzamiento de nuestro servidor MCP (Model Context Protocol), permitiendo que agentes de IA como Claude, n8n o Cursor consulten datos oficiales de Tusdatos Empresas en tiempo real.
¿Qué es el servidor MCP?
Es un estándar de conexión que permite a las Inteligencias Artificiales interactuar directamente con fuentes de datos externas. Al configurar nuestro servidor MCP, tu asistente de IA deja de basarse en datos genéricos y empieza a extraer información precisa (NIT, situación financiera, representantes legales y estados de matrícula) directamente de nuestra plataforma.
Casos de uso destacados
- Due diligence y vinculación: Automatiza la verificación de proveedores o clientes directamente desde tu chat de IA.
- Enriquecimiento de CRM: Completa datos faltantes (CIIU, número de empleados, dirección) sin procesos manuales.
- Análisis sectorial: Pide a tu IA que compare los ingresos de varias empresas o identifique vínculos entre representantes legales.
Ejemplo de interacción
Una vez configurado, no necesitas programar cada consulta. Simplemente escribes en lenguaje natural:
"Consulta el perfil de la empresa [Nombre] y genera un resumen de su capacidad financiera y sus representantes actuales."
Proceso de Implementación
Esta funcionalidad requiere una configuración técnica inicial (edición de archivos JSON o uso de terminal). Si no tienes experiencia técnica, te recomendamos compartir esta guía con tu equipo de desarrollo o sistemas.
Pasos para el acceso:
- Registro Corporativo: Regístrate con un correo empresarial en empresas.tusdatos.co.
- Generación de Credenciales: Ingresa a la configuración del workspace desde el panel de usuario y genera tu Bearer Token.
- Configuración del cliente: Integra el servidor MCP en tu herramienta preferida (Claude Desktop, n8n, etc.) utilizando la URL y el token obtenidos.
- Validación: Una vez conectado, las herramientas
buscar_empresas,informacion_basica_empresaeinformacion_avanzadaestarán disponibles para tu agente.
Configuración por herramienta
El servidor MCP de Tusdatos Empresas utiliza transporte Streamable HTTP con autenticación Bearer Token.
URL del servidor:https://mcp.empresas.tusdatos.co
Para obtener tu token de acceso, regístrate en empresas.tusdatos.co.
Claude Desktop
Claude Desktop no conecta directamente a servidores MCP remotos desde claude_desktop_config.json. Para servidores remotos, se necesita un puente local usando mcp-remote.
Agrega esta configuración en tu archivo claude_desktop_config.json:
{
"mcpServers": {
"Tusdatos-empresas": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.empresas.tusdatos.co/",
"--header",
"Authorization: Bearer <TU_TOKEN>"
]
}
}
}
Esto levanta un puente local que traduce la comunicación stdio de Claude Desktop al transporte HTTP del servidor remoto.
Claude Code
Agrega o modifica el archivo .mcp.json en la raíz de tu proyecto:
{
"mcpServers": {
"Tusdatos-empresas": {
"type": "http",
"url": "https://mcp.empresas.tusdatos.co",
"headers": {
"Authorization": "Bearer <TU_TOKEN>"
}
}
}
}
O usa el comando:
claude mcp add tusdatos -- npx -y mcp-remote@latest https://mcp.empresas.tusdatos.co/ --header "Authorization: Bearer <TU_TOKEN>"
Claude Code detecta automáticamente el archivo y conecta al servidor. Las herramientas buscar_empresas, informacion_basica_empresa e informacion_avanzada estarán disponibles de inmediato.
Gemini CLI
Agrega o modifica el archivo .gemini/settings.json:
{
"mcpServers": {
"Tusdatos-empresas": {
"type": "http",
"url": "https://mcp.empresas.tusdatos.co",
"headers": {
"Authorization": "Bearer <TU_TOKEN>"
}
}
}
}
O usa el comando:
gemini mcp add --transport http --header "Authorization: Bearer <TU_TOKEN>" tusdatos https://mcp.empresas.tusdatos.co/
Gemini detecta automáticamente el archivo y conecta al servidor. Las herramientas buscar_empresas, informacion_basica_empresa e informacion_avanzada estarán disponibles de inmediato.
n8n
n8n soporta MCP a través de su nodo MCP Client Tool.
- Agrega un nodo AI Agent a tu flujo.
- Conecta un nodo MCP Client Tool como herramienta del agente.
- Configura la conexión:
- Transport Type: Streamable HTTP
- URL:
https://mcp.empresas.tusdatos.co/ - Headers:
Authorization: Bearer <TU_TOKEN>
El agente descubrirá automáticamente las herramientas buscar_empresas, informacion_basica_empresa e informacion_avanzada.
Ahora puedes construir flujos donde el agente consulte datos empresariales colombianos como parte de un proceso más amplio: enriquecer leads, validar proveedores o generar reportes automáticos.
Pydantic AI
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
Tusdatos_empresas_server = MCPServerHTTP(
url="https://mcp.empresas.tusdatos.co",
headers={"Authorization": "Bearer <TU_TOKEN>"},
)
agent = Agent(
"anthropic:claude-sonnet-4-6",
mcp_servers=[Tusdatos_empresas_server],
)
async def main():
async with agent.run_mcp_servers():
result = await agent.run(
"Busca la empresa Alpina y dame su informacion financiera"
)
print(result.output)
Pydantic AI se encarga de descubrir las herramientas, gestionar la conexión y codificar las respuestas automáticamente.
Disponibilidad y Límites
- Acceso gratuito: Hasta 100 consultas diarias incluidas para pruebas y flujos de bajo volumen.
- ¿Necesitas más consultas diarias? Para implementaciones de alto volumen o automatizaciones masivas, contáctanos a soporte@tusdatos.co para obtener una oferta personalizada.