集成

自定义 MCP(Custom MCP)

将 Castrel 连接到任意遵循 MCP 协议的外部服务器,自动发现并加载其暴露的工具。

概览

  • 连接器名称custom_mcp
  • 协议:Model Context Protocol(MCP)
  • 传输类型:Streamable HTTP / SSE
  • 官方文档MCP 协议文档

配置

要使用自定义 MCP 服务器,你需要配置一个包含以下字段的 Connector:

字段必填说明
instance_name连接器实例的展示名称
runtime_mode运行模式:direct(后端直连)或 bridge(通过 Bridge 代理)
base_urlMCP 端点 URL(runtime_mode=direct 时必填)
transport_type传输类型:streamable_http(默认)或 sse
bridge_client_id已配对的 Bridge Node client_id(runtime_mode=bridge 时必填)
bridge_server_nameBridge 侧 MCP server 名称(runtime_mode=bridge 时建议填写)
headers附加到请求的自定义 HTTP 头(用于认证)

可用工具

自定义 MCP 连接器在建立连接后,自动发现服务器端暴露的所有工具,无需手动配置。

  • 工具自动发现:连接后自动列举 MCP 服务器提供的所有工具
  • 动态工具调用:AI 可直接调用服务器暴露的任意工具
  • Bridge 模式:支持通过 Castrel Bridge 访问内网 MCP 服务,无需公网暴露

常用链接