logo
AgentLed

MCP Connection

Conecte AgentLed a Claude Code, Cursor, Windsurf, Codex o cualquier cliente compatible con MCP. Un comando para configurar, una clave API para autenticar.

Cómo funciona MCP

AgentLed se ejecuta como un servidor MCP (Protocolo de contexto modelo). Su cliente AI se conecta a él a través de stdio, lo que le brinda a AI acceso directo a más de 100 integraciones, orquestación de flujo de trabajo y Knowledge Graph, todo autenticado con una única clave API.

El servidor se distribuye como un paquete npm (@agentled/mcp-server). Su cliente MCP lo inicia como un subproceso y se comunica a través de stdin/stdout.

Claude Code

Recomendado: instale el complemento. Incluye el servidor MCP y la habilidad AgentLed (workflow-authoring y Claude se cargan automáticamente) en un solo paso. Dentro de Claude Code, ejecuta:

/plugin marketplace add Agentled/mcp-server
/plugin install agentled@agentled

Luego configure su clave API en el shell desde el que inicia Claude Code:

export AGENTLED_API_KEY=wsk_...

Alternativamente, registre solo el servidor MCP manualmente (omita esto si instaló el complemento; al hacer ambas cosas, se ejecutan dos procesos de servidor idénticos):

claude mcp add agentled \
  -e AGENTLED_API_KEY=wsk_... \
  -- npx -y @agentled/mcp-server

Reemplazar wsk_... con su clave API real. Ver API Claves para saber cómo generar uno.

OpenAI Codex

codex mcp add agentled \
  -e AGENTLED_API_KEY=wsk_... \
  -- npx -y @agentled/mcp-server

Aviso: el @agentled/mcp-server El paquete ya no envía un agentled binario (entraba en conflicto con @agentled/cli). Instalar @agentled/cli para el comando de terminal; usar npx -y @agentled/mcp-server para MCP.

Cursor / Windsurf

Agregue lo siguiente a su archivo JSON de configuración MCP:

{
  "mcpServers": {
    "agentled": {
      "command": "npx",
      "args": ["-y", "@agentled/mcp-server"],
      "env": {
        "AGENTLED_API_KEY": "wsk_..."
      }
    }
  }
}

En Cursor, abra Configuración > MCP y pegue la configuración. En Windsurf, editar ~/.windsurf/mcp_settings.json.

Otros clientes de MCP

Cualquier cliente que admita el transporte stdio MCP puede conectarse. El patrón general:

1.Establecer la variable de entorno AGENTLED_API_KEY a la clave de tu espacio de trabajo

2.Lanzamiento npx -y @agentled/mcp-server como un subproceso

3.Comunicarse a través de stdin/stdout usando el protocolo MCP

Solución de problemas

"Se requiere AGENTLED_API_KEY"

El servidor no pudo encontrar su clave API. Asegúrate de que -e AGENTLED_API_KEY=wsk_... flag está configurado en el comando MCP add, o que la variable de entorno se exporta en su shell.

"npx: comando no encontrado"

Instale Node.js 18+ desde nodejs.org. Verificar con npx --version.

El servidor se conecta pero las herramientas no aparecen

Reinicie su cliente MCP después de agregar el servidor. Algunos clientes requieren un reinicio completo para descubrir nuevas herramientas MCP.

Errores de autenticación (401/403)

Compruebe que su clave API comience con wsk_ y no ha sido revocado. Generar una nueva clave desde Workspace Settings > Developer en el panel AgentLed.

Próximos pasos