Conexión para agentes

Tu equipo puede consultar LicitaIA desde su asistente

Conecta un cliente MCP con la misma clave de tu API y pide búsquedas, fichas y análisis de licitaciones españolas desde el flujo de trabajo habitual.

Ver planes y preciosVer la guía de la API

Endpoint

Una conexión, ocho herramientas

https://api.licitaia.org/api/mcp

El servidor usa Streamable HTTP y la clave va en Authorization: Bearer …. No pongas claves en URLs, prompts, analítica ni documentos compartidos. La API está incluida en Pro (5.000 llamadas/mes, 2 claves) y Team (50.000 llamadas/mes, 10 claves); el alta incluye 14 días de Pro sin tarjeta.

  • buscar_licitaciones
  • ficha_licitacion
  • recomendadas
  • veredicto_guardado
  • calcular_veredicto
  • analizar_pliegos
  • estado_analisis
  • leer_analisis
01

Elige tu cliente

Claude, Claude Code, Codex, Cursor y MCP Inspector pueden usar una conexión HTTP con cabeceras. Las instrucciones de abajo separan cada caso.

02

Configura la clave

Crea o reutiliza una clave desde Equipo · API. Se muestra una sola vez y conserva los permisos que elijas.

03

Prueba una búsqueda

Empieza con una lectura: Busca licitaciones abiertas en Cantabria con CPV 72 (servicios TI). Después prueba Consulta el análisis guardado.

Claude / conectores personalizados

Claude.ai o Claude Desktop

  1. Abre Personalizar → Conectores → Añadir.
  2. Introduce primero el nombre del conector y la URL del endpoint; después pulsa Continuar.
  3. Elige Sin inicio de sesión y añade en Encabezados de solicitud el nombre Authorization y valor Bearer TU_CLAVE.

Conexión y búsqueda verificadas en Claude.ai el 6 de octubre de 2026 con una clave de solo lectura. La configuración de Desktop sigue la documentación oficial. «Sin inicio de sesión» significa que el conector no usa OAuth: el servidor sigue requiriendo la cabecera con tu clave.

Instrucciones oficiales de Claude

Claude Code

Terminal

claude mcp add --transport http licitaia https://api.licitaia.org/api/mcp --header "Authorization: Bearer TU_CLAVE"

El ejemplo usa un marcador. Sustitúyelo en tu terminal o usa la tarjeta privada de Equipo · API.

Codex

config.toml

[mcp_servers.licitaia]
url = "https://api.licitaia.org/api/mcp"
http_headers = { Authorization = "Bearer TU_CLAVE" }

Guárdalo en ~/.codex/config.toml. Codex usa esta sección, no el JSON de otros clientes.

Cursor / Inspector

JSON de conexión

{
  "mcpServers": {
    "licitaia": {
      "url": "https://api.licitaia.org/api/mcp",
      "headers": { "Authorization": "Bearer TU_CLAVE" }
    }
  }
}

Copia el bloque en la configuración MCP del cliente. No compartas el archivo con una clave real.

Permisos y coste

Empieza por lecturas

Los cuatro permisos de lectura consultan licitaciones, recomendaciones, análisis y veredictos. calcular_veredicto guarda el veredicto para tu empresa, pero no cobra. analizar_pliegos consume 2 créditos; configura una aprobación explícita para el permiso analisis:write antes de permitirlo.

La cuota mensual es compartida por la organización: crear otra clave no la multiplica. La cuota por minuto sí se limita por clave.

ChatGPT todavía requiere OAuth para este tipo de conexión. La integración directa con una clave no está prometida. Consulta la documentación oficial de autenticación de OpenAI.

Si algo falla

Comprueba esto primero

  • 401: revisa que la cabecera sea Authorization: Bearer lic_live_… y que la clave siga activa.
  • 403: comprueba el plan Pro o Team y el scope de la herramienta.
  • 429: espera el tiempo indicado y recuerda que la cuota es de toda la organización.
  • SCOPE_REQUIRED: añade solo el permiso mínimo que necesita el flujo.