Conectar um Agente

Aponte qualquer framework de agente AI compatível com MCP para o gateway Edison Watch - uma URL, sem configuração de cabeçalhos. O guia de conexão canônico por trás de cada quickstart de framework.

Se você está desenvolvendo seu próprio agente - em vez de conectar um aplicativo empacotado como Claude ou ChatGPT - você o conecta ao Edison da mesma forma que se conectaria a qualquer servidor MCP remoto: aponte o cliente MCP do seu framework para a URL do gateway Edison. Cada ferramenta de cada servidor que você habilitou aparece como uma ferramenta MCP normal, e cada chamada que seu agente faz é monitorada e aplicada por políticas em tempo real.

Esta página é o guia de conexão canônico. Cada quickstart de framework nesta seção é uma camada fina em torno do que está aqui - leia isto uma vez e depois vá para o seu framework.

A única coisa a entender: sua credencial está na URL

O Edison não usa um cabeçalho Authorization para a conexão MCP. Sua chave de API é um segmento da própria URL de conexão:

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)

Qualquer coisa que possa abrir uma conexão MCP streamable-HTTP para uma URL pode se conectar ao Edison - sem cabeçalhos personalizados, sem cliente OAuth, sem troca de tokens. Isso torna o Edison compatível com praticamente todos os frameworks de agentes, incluindo os muitos que ainda não permitem definir cabeçalhos de requisição.

Trate sua URL de conexão como uma senha. Qualquer pessoa que a possua pode chamar ferramentas MCP como você, sujeito aos seus Níveis de Controle de Acesso e regras de política. Não a commite no controle de versão - carregue-a a partir de uma variável de ambiente.

Não adicione um cabeçalho Authorization: Bearer ao seu cliente MCP - o Edison lê a chave apenas do caminho da URL, portanto um cabeçalho bearer não faz nada aqui. (O Edison usa Authorization: Bearer para sua API REST de gerenciamento em /api/v1/..., mas essa é uma superfície separada da conexão MCP.)

1. Obtenha sua URL de conexão

Sua URL pessoal incorpora sua chave de API (formato: edison_ seguido de ~40 caracteres). Obtenha-a no painel Edison Watch: abra as Settings, encontre a seção Api key / MCP URL e clique em Get MCP URL. Você também pode copiar a URL base no menu Copy MCP URL do aplicativo desktop Edison Watch.

O host do gateway difere por ambiente - o release usa mcp.edison.watch, enquanto implantações demo e self-hosted usam seu próprio host. Sempre copie a URL do seu painel ou aplicativo desktop em vez de fixar mcp.edison.watch no código.

Armazene-a como uma variável de ambiente para que seu código nunca contenha a chave literalmente:

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

O sufixo opcional ?client=<label> marca a sessão no painel Edison para que você possa distinguir o tráfego deste agente dos seus outros conectores. Use qualquer rótulo curto que preferir (my-agent, langgraph-prod, etc.).

2. Aponte seu framework para ele

Todo framework nesta seção se resume ao mesmo movimento: passe EDISON_MCP_URL para o cliente MCP streamable-HTTP desse framework e deixe-o descobrir as ferramentas. Aqui está a forma em Python puro, usando o SDK MCP oficial - todo framework de nível superior envolve exatamente isso:

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

Observe que não há argumento headers= - a credencial já está na url. Escolha seu framework abaixo para a versão idiomática.

O gateway do Edison usa apenas streamable-HTTP. Se um framework pedir para você escolher um transporte, escolha streamable-HTTP (às vezes escrito como http ou streamable_http) - não SSE, que está obsoleto na especificação MCP e não é servido pelo gateway.

Escolha seu framework

OpenAI Agents SDK

Python & TypeScript. O SDK multi-agente oficial da OpenAI.

Claude Agent SDK

Python & TypeScript. O SDK de agentes da Anthropic por trás do Claude Code.

LangChain / LangGraph

Python & JS. O maior ecossistema de agentes.

Pydantic AI

Python. Agentes type-safe e nativos do Pydantic.

LlamaIndex

Python & TS. Agentes centrados em dados e recuperação.

Google ADK

Python. O Kit de Desenvolvimento de Agentes do Google para Gemini.

Microsoft Agent Framework

Python & .NET. O sucessor do Semantic Kernel + AutoGen.

Vercel AI SDK

TypeScript. O SDK dominante para desenvolvedores de aplicativos AI.

Mastra

TypeScript. Framework de agentes TS com baterias incluídas.

DSPy

Python. Programar - não prompts - modelos de linguagem.

Segredos criptografados

Alguns servidores habilitados usam segredos com criptografia zero-knowledge. Para permitir que o gateway os descriptografe, um cliente pode enviar um cabeçalho opcional x-edison-secret-key - separado da sua chave de API e utilizável apenas por frameworks que permitem cabeçalhos de requisição personalizados. O Edison ainda se conecta sem ele; apenas servidores que precisam de um segredo criptografado falham ao descriptografar. Cada página de framework abaixo mostra exatamente onde configurá-lo.

Níveis de Controle de Acesso

Como o Edison classifica ferramentas como PUBLIC, PRIVATE ou SECRET.

Regras de política

As regras CEL que controlam o que seu agente pode fazer em tempo de execução.