Conecta tu agente de IA a BDC AI (MCP y API)

Conector con un click (OAuth)

Usa este camino si trabajas desde Claude Desktop o claude.ai: no hay llave que copiar ni que rotar, el agente actúa con tus propios permisos de usuario.

1. En Claude, abre Configuración → Conectores → Agregar conector personalizado.
2. Pega la URL https://bdcai.com/mcp y confirma.
3. Claude descubre el servidor de autorización automáticamente (RFC 9728, vía /.well-known/oauth-protected-resource) e inicia el flujo OAuth.
4. Inicia sesión con tu cuenta de BDC AI y autoriza el acceso en /oauth/consent. El agente queda conectado con tus permisos, sin scopes propios que configurar.

Configuración → Conectores → Agregar conector personalizado
URL: https://bdcai.com/mcp

Llave de API

Usa este camino si trabajas desde Claude Code, Cursor, n8n o un script propio: necesitas una credencial de larga duración con scopes explícitos que puedas revocar sin tocar la sesión de nadie.

1. Crea una llave en Ajustes → Integraciones → API y agentes (/settings/canales/api). El módulo API debe estar encendido en tu organización.
2. Elige solo los scopes que tu integración necesita (contacts:read, conversations:write, messages:send…). El valor completo (bdc_live_…) se muestra una sola vez.
3. Configura tu cliente MCP con la URL https://bdcai.com/mcp y el header Authorization: Bearer bdc_live_….
4. Si algo se ve raro, revoca la llave desde el mismo panel: el acceso se corta de inmediato, sin afectar a otras llaves.

claude mcp add --transport http bdcai https://bdcai.com/mcp \
  --header "Authorization: Bearer bdc_live_…"

{
  "mcpServers": {
    "bdcai": {
      "url": "https://bdcai.com/mcp",
      "headers": {
        "Authorization": "Bearer bdc_live_…"
      }
    }
  }
}

Nodo "MCP Client Tool"
Endpoint del servidor MCP: https://bdcai.com/mcp
Authentication: Bearer
Bearer Token: bdc_live_…

Skill instalable

Un skill de Claude con las reglas de negocio ya resumidas (ventana de 24 horas, plantillas aprobadas, cómo leer un pipeline) para que el agente no tenga que redescubrirlas llamando a org.describe cada vez.

1. npx skills add sebastiang90/bdcai-skill
2. El skill trae su propia referencia de la API generada desde el mismo registro que usa /docs/api: nunca queda desactualizada a mano.
3. Combínalo con cualquiera de los dos caminos de arriba: el skill no reemplaza la conexión MCP, la complementa con contexto.

Preguntas frecuentes