เชื่อมต่อ Agent

หากคุณกำลังสร้าง agent ของตัวเอง - แทนที่จะเชื่อมต่อแอปสำเร็จรูปอย่าง Claude หรือ ChatGPT - คุณสามารถเชื่อมต่อกับ Edison ได้ในแบบเดียวกับที่คุณเชื่อมต่อกับ remote MCP server ทั่วไป: ชี้ MCP client ของ framework ของคุณไปยัง Edison gateway URL ของคุณ เครื่องมือทุกอย่างจากทุก server ที่คุณเปิดใช้งานจะปรากฏเป็น MCP tool ปกติ และทุกการเรียกใช้ที่ agent ของคุณทำจะถูกตรวจสอบและบังคับใช้ policy ในเวลาจริง

หน้านี้คือ คู่มือการเชื่อมต่อหลัก ของส่วนนี้ quickstart ของแต่ละ framework ในส่วนนี้เป็นเพียง wrapper บางๆ ของสิ่งที่อยู่ที่นี่ - อ่านหน้านี้ครั้งเดียว แล้วข้ามไปยัง framework ของคุณ

สิ่งหนึ่งที่ต้องเข้าใจ: credential ของคุณอยู่ใน URL

Edison ไม่ใช้ header Authorization สำหรับการเชื่อมต่อ MCP API key ของคุณเป็น ส่วนหนึ่งของ connection URL นั้นเอง:

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)

ทุกสิ่งที่สามารถเปิดการเชื่อมต่อ MCP แบบ streamable-HTTP ไปยัง URL ได้สามารถเชื่อมต่อกับ Edison ได้ - ไม่ต้องใช้ custom headers, ไม่ต้องใช้ OAuth client, ไม่ต้องมีการแลกเปลี่ยน token ทำให้ Edison เข้ากันได้กับ agent framework แทบทุกตัว รวมถึงตัวที่ยังไม่รองรับการตั้งค่า request headers

1. รับ connection URL ของคุณ

URL ส่วนตัวของคุณมี API key ฝังอยู่ (รูปแบบ: edison_ ตามด้วยประมาณ 40 ตัวอักษร) รับได้จาก Edison Watch dashboard: เปิด Settings หาส่วน Api key / MCP URL แล้วคลิก Get MCP URL คุณยังสามารถคัดลอก base URL จาก Edison Watch desktop app ในเมนู Copy MCP URL

เก็บเป็น environment variable เพื่อให้ code ของคุณไม่มี key โดยตรง:

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

suffix ?client=<label> ที่เป็นทางเลือกจะแท็ก session ใน Edison dashboard เพื่อให้คุณแยก traffic ของ agent นี้ออกจาก connector อื่นๆ ได้ ใช้ label สั้นๆ ตามต้องการ (my-agent, langgraph-prod เป็นต้น)

2. ชี้ framework ของคุณไปที่มัน

ทุก framework ในส่วนนี้ล้วนลงเอยด้วยการกระทำเดียวกัน: ส่ง EDISON_MCP_URL ให้กับ streamable-HTTP MCP client ของ framework นั้นและปล่อยให้มันค้นพบ tools ต่อไปนี้คือรูปแบบใน Python ดิบๆ โดยใช้ MCP SDK อย่างเป็นทางการ - ทุก framework ระดับสูงกว่าจะ wrap สิ่งนี้ทั้งหมด:

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

สังเกตว่าไม่มี argument headers= - credential อยู่ใน url แล้ว เลือก framework ด้านล่างสำหรับเวอร์ชัน idiomatic

เลือก framework ของคุณ

ความลับที่เข้ารหัส

บาง server ที่เปิดใช้งานใช้ ความลับที่เข้ารหัสแบบ zero-knowledge เพื่อให้ gateway ถอดรหัสได้ client อาจส่ง header x-edison-secret-key ที่เป็นทางเลือก - แยกจาก API key ของคุณ และใช้ได้เฉพาะกับ frameworks ที่อนุญาตให้ตั้งค่า custom request headers Edison ยังเชื่อมต่อได้โดยไม่มีมัน เฉพาะ server ที่ต้องการ encrypted secret เท่านั้นที่จะถอดรหัสไม่ได้ หน้าของแต่ละ framework ด้านล่างแสดงตำแหน่งที่แน่นอนในการตั้งค่า