Conectar agentes

Para conectar un cliente MCP compatible, usa el endpoint remoto de LicitaIQ:

https://api.licitaiq.cl/mcp

El endpoint usa Streamable HTTP JSON-RPC mediante POST /mcp.

Metadata OAuth

Los clientes compatibles pueden descubrir la metadata del recurso protegido en:

https://api.licitaiq.cl/.well-known/oauth-protected-resource/mcp

LicitaIQ usa Auth0/OAuth. Cada solicitud debe incluir un token Bearer válido con audience correcto y scopes suficientes para la tool que se quiere ejecutar.

Qué revisar al conectar

que el cliente MCP soporte endpoint remoto con token Bearer
que el token solicitado incluya los scopes necesarios
que el usuario pertenezca a la organización correcta si usará tools de pipeline
que el plan tenga licitaciones preparadas o búsquedas documentales disponibles

Compatibilidad

La compatibilidad final depende del cliente MCP que uses. Algunos clientes pueden requerir configuración manual del endpoint y otros pueden leer la metadata OAuth del recurso protegido.

ChatGPT

Para probar LicitaIQ MCP en ChatGPT, usa Developer Mode.

En ChatGPT, abre Settings -> Apps & Connectors -> Advanced settings.
Activa Developer Mode si tu plan y organización lo permiten.
Crea un conector nuevo desde Settings -> Connectors.
Usa como URL:
```
https://api.licitaiq.cl/mcp
```
Completa el flujo OAuth cuando ChatGPT lo solicite.

Abre una conversación nueva, habilita el conector y prueba prompts simples como:

Busca licitaciones públicas sobre software y dime cuáles conviene revisar primero.

Según la documentación de OpenAI, Developer Mode entrega acceso MCP completo para herramientas de lectura y escritura, por lo que debe usarse solo para pruebas controladas. Revisa la guía oficial de ChatGPT Developer Mode, la guía para conectar desde ChatGPT y la guía de testing de Apps SDK.

Si pruebas un servidor local, ChatGPT necesita que el endpoint sea accesible por HTTPS. Puedes usar un túnel seguro y apuntar el conector a la URL pública del túnel terminada en /mcp.

Claude

Claude también puede conectarse a servidores MCP remotos, pero hay dos caminos comunes.

Claude web o Claude Desktop

Para Claude web, Claude Desktop, Cowork o mobile con conectores remotos:

Abre Customize -> Connectors.
Selecciona Add custom connector.
Ingresa el endpoint remoto:
```
https://api.licitaiq.cl/mcp
```
Si Claude muestra configuración avanzada de OAuth, usa los datos entregados por LicitaIQ o completa el login cuando el conector lo solicite.
Habilita el conector en la conversación desde el botón de conectores.

La guía de Anthropic indica que los conectores remotos se alcanzan desde la infraestructura cloud de Claude, no desde tu máquina local. Por eso el endpoint debe estar disponible públicamente para Claude. Revisa la guía oficial de custom connectors con remote MCP.

Claude Code

Para Claude Code puedes agregar el servidor remoto por HTTP:

claude mcp add --transport http licitaiq https://api.licitaiq.cl/mcp

Luego abre Claude Code y ejecuta:

/mcp

Si el servidor requiere OAuth, Claude Code mostrará el flujo de autenticación. La documentación oficial de Claude Code recomienda HTTP para servidores remotos y usa /mcp para autenticar servidores con OAuth. Revisa Connect Claude Code to tools via MCP.

Endpoint GET

GET /mcp no habilita transporte SSE. Si lo llamas directamente, la API indicará que debes usar POST /mcp.

Siguiente paso recomendado: Tools disponibles.