Conectar un Agente

Apunta cualquier framework de agente de IA compatible con MCP al gateway de Edison Watch - una URL, sin configuración de cabeceras. La guía de conexión canónica detrás de cada inicio rápido de framework.

Si estás creando tu propio agente - en lugar de conectar una aplicación empaquetada como Claude o ChatGPT - lo conectas a Edison de la misma forma en que te conectarías a cualquier servidor MCP remoto: apunta el cliente MCP de tu framework a tu URL de gateway de Edison. Cada herramienta de cada servidor que hayas habilitado aparece como una herramienta MCP normal, y cada llamada que realiza tu agente es monitoreada y sometida a políticas en tiempo real.

Esta página es la guía de conexión canónica. Cada inicio rápido de framework en esta sección es una envoltura delgada de lo que se encuentra aquí - lee esto una vez y luego ve a tu framework.

Lo único que debes entender: tu credencial vive en la URL

Edison no usa una cabecera Authorization para la conexión MCP. Tu clave API es un segmento de la propia URL de conexión:

https://mcp.edison.watch/mcp/<your-api-key>/?client=<label>
└──────────┬───────────┘└─┬─┘└─────┬──────┘└┬┘└──────┬──────┘
      gateway host      fixed   your API key  │   optional session
   (per-org, see below) prefix (edison_...)   │   label for the
                                     trailing slash   dashboard
                                     (required)

Cualquier cosa que pueda abrir una conexión MCP streamable-HTTP a una URL puede conectarse a Edison - sin cabeceras personalizadas, sin cliente OAuth, sin intercambio de tokens. Eso hace que Edison sea compatible con prácticamente todos los frameworks de agentes, incluidos los muchos que (todavía) no permiten configurar cabeceras de solicitud.

Trata tu URL de conexión como una contraseña. Cualquiera que la tenga puede llamar a las herramientas MCP como tú, sujeto a tus Niveles de Control de Acceso y reglas de política. No la incluyas en el control de versiones - cárgala desde una variable de entorno.

No añadas una cabecera Authorization: Bearer a tu cliente MCP - Edison lee la clave únicamente de la ruta URL, por lo que una cabecera bearer no hace nada aquí. (Edison sí usa Authorization: Bearer para su API REST de gestión en /api/v1/..., pero esa es una superficie separada de la conexión MCP.)

1. Obtén tu URL de conexión

Tu URL personal incorpora tu clave API (formato: edison_ seguido de ~40 caracteres). Obtenla desde el panel de control de Edison Watch: abre Settings, encuentra la sección Api key / MCP URL y haz clic en Get MCP URL. También puedes copiar la URL base desde el menú Copy MCP URL de la aplicación de escritorio de Edison Watch.

El host del gateway varía según el entorno - la versión de producción es mcp.edison.watch, mientras que las implementaciones demo y autohospedadas usan su propio host. Siempre copia la URL desde tu panel de control o aplicación de escritorio en lugar de hardcodear mcp.edison.watch.

Guárdala como una variable de entorno para que tu código nunca contenga la clave literalmente:

export EDISON_MCP_URL="https://mcp.edison.watch/mcp/edison_your_key_here/?client=my-agent"

El sufijo opcional ?client=<label> etiqueta la sesión en el panel de control de Edison para que puedas distinguir el tráfico de este agente del de tus otros conectores. Usa cualquier etiqueta corta que prefieras (my-agent, langgraph-prod, etc.).

2. Apunta tu framework hacia él

Cada framework en esta sección se reduce al mismo movimiento: entregar EDISON_MCP_URL al cliente MCP streamable-HTTP de ese framework y dejar que descubra las herramientas. Aquí está la forma en Python puro, usando el SDK oficial de MCP - cada framework de nivel superior envuelve exactamente esto:

import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    url = os.environ["EDISON_MCP_URL"]
    async with streamablehttp_client(url) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])  # tools from every enabled server

Nótese que no hay argumento headers= - la credencial ya está en url. Elige tu framework a continuación para la versión idiomática.

El gateway de Edison habla streamable-HTTP únicamente. Si un framework te pide elegir un transporte, elige streamable-HTTP (a veces escrito http o streamable_http) - no SSE, que está obsoleto en la especificación MCP y no es servido por el gateway.

Elige tu framework

OpenAI Agents SDK

Python y TypeScript. El SDK multi-agente oficial de OpenAI.

Claude Agent SDK

Python y TypeScript. El SDK de agentes de Anthropic detrás de Claude Code.

LangChain / LangGraph

Python y JS. El ecosistema de agentes más grande.

Pydantic AI

Python. Agentes de tipado seguro, nativos de Pydantic.

LlamaIndex

Python y TS. Agentes centrados en datos y recuperación de información.

Google ADK

Python. El Kit de Desarrollo de Agentes de Google para Gemini.

Microsoft Agent Framework

Python y .NET. El sucesor de Semantic Kernel + AutoGen.

Vercel AI SDK

TypeScript. El SDK dominante para desarrolladores de aplicaciones de IA.

Mastra

TypeScript. Framework de agentes en TS con pilas incluidas.

DSPy

Python. Programar - no prompting - modelos de lenguaje.

Secretos cifrados

Algunos servidores habilitados usan secretos cifrados de conocimiento cero. Para permitir que el gateway los descifre, un cliente puede enviar una cabecera opcional x-edison-secret-key - separada de tu clave API, y solo utilizable por frameworks que permiten cabeceras de solicitud personalizadas. Edison sigue conectándose sin ella; solo los servidores que necesitan un secreto cifrado fallan al descifrar. Cada página de framework a continuación muestra exactamente dónde configurarlo.

Access Control Levels

Cómo Edison clasifica las herramientas como PUBLIC, PRIVATE o SECRET.

Reglas de política

Las reglas CEL que controlan lo que tu agente puede hacer en tiempo de ejecución.