DocsHệ Sinh thái mở rộngSự Kết hợp MCP

Sự Kết hợp MCP

Đính kèm bất kỳ máy chủ MCP nào như một công cụ cho một Agent trong luồng công việc của bạn, mở rộng những gì nó có thể làm.

MCP ( giao thức văn bản đồ thị) là một giao thức mở để cung cấp công cụ bên ngoài cho một LM theo cách đồng nhất. Tại Braidrun, MCP treo lên một Agent: cấu hình một hay nhiều máy chủ MCP trên một Agent, và các công cụ mà các máy chủ đó phơi bày xuất hiện trong danh sách công cụ được gọi, giống như công cụ xây dựng sẵn.

Cách nó hoạt động

MCP conbig là per-Agent: trong workflow YAML, mỗi máy chủ của Agent là một bản đồ "danh sách config", và bạn có thể gắn nhiều máy chủ cùng một lúc. Trước khi thực hiện một bước, thời gian chạy kết nối với mỗi máy chủ và kết hợp công cụ của họ vào danh sách của Agent.

Khi máy phục vụ MCP không kết nối được, thời gian chạy sẽ ghi lại cảnh báo và bỏ qua các công cụ của nó mà không ngắt toàn bộ luồng công việc — các máy phục vụ khác và các công cụ xây dựng sẵn có. Nếu một bước phụ thuộc vào một công cụ từ một máy chủ không kết nối, thất bại xuất hiện trong nhật ký thực hiện bước đó.

Tên

Hình thức phổ biến nhất: máy phục vụ MCP là một tiến trình cục bộ mà thời gian chạy khởi động với lệnh + args và giao tiếp với thông tin qua đầu vào/tắt chuẩn. Khi tuyên bố một Agent có sẵn, hãy đặt mcp hosts bên trong ghi đè:

yaml

agents:
  researcher:
    preset: universal
    overrides:
      mcp_servers:
        github:
          command: npx
          args: ["-y", "@modelcontextprotocol/server-github"]
          env:
            GITHUB_PERSONAL_ACCESS_TOKEN: "<your-token>"
          description: "读写 GitHub 仓库与 issue"

Trong chế độ định sẵn nó phải đi trong ghi đè

Khi một Agent tuyên bố đã có sẵn, thời gian chạy chỉ kết hợp các mặc định sẵn và các trường bên trong ghi đè; mcp máy chủ viết ở cấp cao nhất của Agent bị bỏ qua.

Kết nối đến máy chủ từ xa

Máy phục vụ MCP cũng có thể là dịch vụ mạng: set url và nó không còn sử dụng sdio, và gõ quyết định giao thông (sse, websoet, http); nếu kiểu gõ là bỏ qua nó mặc định là sse.

yaml

agents:
  analyst:
    preset: universal
    overrides:
      mcp_servers:
        crm:
          url: "https://mcp.example.com/sse"
          type: sse
          timeout: 60000
        docs-search:
          url: "https://mcp.example.com/mcp"
          type: http
          enabled: true

Dịch vụ mà url chỉ ra rằng cần phải có thể đạt được từ môi trường thời gian chạy của công việc - sử dụng một địa chỉ có thể tiếp cận công khai, chứ không chỉ có thể truy cập vào máy của bạn.

Tham chiếu về lĩnh vực

Tìm kiếm	Mô tả
`command`	Lệnh khởi động cho chế độ stdio (tên hay đường dẫn thực hiện được); cần thiết trong chế độ stdio
`args`	Danh sách các đối số dòng lệnh
`env`	Biến môi trường được truyền cho quá trình trẻ em bị hạn chế; giấy ủy nhiệm được chuyển vào đây
`cwd`	Thư mục hoạt động của tiến trình con stdio; nếu bỏ qua, mặc định thời gian chạy sẽ được dùng
`url`	Địa chỉ máy phục vụ từ xa; một khi url đã thiết lập, nó không còn sử dụng sdio
`type`	Kiểu giao thông: sdio (mặc định), sse, websoet, http; chỉ có hiệu lực khi url được đặt, và mặc định là sse nếu bị bỏ qua
`timeout`	Thời hạn trong phần nghìn giây, mặc định 30.000
`enabled`	Mặc định là đúng; đặt nó là sai để tạm thời tắt máy phục vụ mà không xóa cấu hình
`description`	Tên

Ghi chú thiết lập và mạng

Quá trình trẻ em sdio không thừa kế tất cả các biến môi trường thời gian chạy: chỉ có một vài điều cơ bản giống như cha mẹ, nhà và LANG, cộng với bất cứ điều gì bạn viết rõ ràng bằng env, được thông qua. Bất kỳ phím ARI nào thì máy chủ MCP cần phải được viết rõ ràng bằng env.
Các giá trị trong env được lưu trữ trong văn bản đơn giản trong luồng công việc YAML. Trước khi chia sẻ một luồng công việc hoặc xuất bản một mẫu, thay thế các bí mật thật bằng các bộ giữ chỗ và để người dùng tự điền vào.
Dùng địa chỉ HTTPS cho máy phục vụ ở xa; lỗi kết nối bị bỏ qua như được mô tả ở trên, vì vậy bạn có thể kiểm tra bản ghi thực hiện trước để xác nhận các công cụ đã đăng ký có thành công hay không.
Càng nhiều công cụ, không gian quyết định của Agent càng lớn. Chỉ gắn các máy chủ mà Agent này thực sự sử dụng, và cả tốc độ thành công lẫn tốc độ cải thiện.

Hiển thị công cụ Braidrun trên MCP

Đường dẫn này là hai chiều quá: các công cụ đã được xây dựng riêng của Braidrun được đóng gói như một trình phục vụ MCP stdio (có tên là crixrun-work luồng), do đó, cùng một công cụ thiết lập có thể được sử dụng lại bởi các khách hàng MCP khác thông qua giao thức MCP.

Quan hệ với luật Claude / Cổ bản

Trong sản phẩm này, trợ lý AI có thể sử dụng Kong, Claude Code, hoặc Codex là thời gian chạy, với khả năng đăng nhập dài hạn được hỗ trợ tại vị trí của một khóa API. Để đổi giờ, gặp trợ lý của AI.