观测云 MCP Server 接入和使用最佳实践

MCP 介绍

MCP Server，模型上下文协议（Model Context Protocol，简称 MCP）是一个开放协议，旨在标准化应用程序与 AI 模型之间的安全连接和数据源访问。它的核心目标是让开发者能够通过统一的"工具"和"资源"，轻松地为模型提供上下文信息（如数据、内容、操作），从而增强模型能力，而无需重新训练模型。

基于 MCP Server 构建的服务，最终提供一个统一的多模型可调用接口。该服务支持多客户端接入，并采用 API Key 鉴权机制，以此安全访问观测云的各项核心功能，包括监控器、日志、仪表板及 DQL 查询。

观测云

观测云是一款专为 IT 工程师打造的全链路可观测产品，它集成了基础设施监控、应用程序性能监控和日志管理，为整个技术栈提供实时可观察性。这款产品能够帮助工程师全面了解端到端的用户体验追踪，了解应用内函数的每一次调用，以及全面监控云时代的基础设施。此外，观测云还具备快速发现系统安全风险的能力，为数字化时代提供安全保障。

MCP Server 接入

此处以通过 Cherry Studio 接入方式为例。

1、下载 MCP Server 客⼾端 Cherry Studio，选择对应版本

2、打开 Cherry Studio，点击设置，点击 MCP，点击添加

提示：如果 mcp 服务不能开启请安装 UV Bun

3、MCP Server 设置

3.1 设置 MCP 服务器名称（这里以命名 MCP 服务器为例）点击类型选择 streamableHttp

3.2 配置URL以及请求头

定义 URL：https://obsy-ai.guance.com/obsy_ai_mcp/mcp

请求头格式为：Authorization=DF-API-KEY;Endpoint=SITE_KEY

配置说明

接⼝以 API KEY 为认证⽅式，每⼀次请求使⽤请求体 Header 中的 DF-API-KEY 的值作为有效性检验，以及本次请求的⼯作空间限定依据（取此 DF-API-KEY 所属的⼯作空间）；
当前 MCP 服务所展⽰的所有接⼝都只需要提供 API KEY （Header：DF-API-KEY）作为凭证。如果凭据存在且有效，则视为认证通过。
MCP Endpoint 配置参数为 SITE_KEY，例如: cn1。具体对应 MAP 参考如下：

makefile 复制代码

SITE_KEY_MAP = {
    # === 中国区 SaaS 部署 ===
    "cn1": "https://openapi.guance.com",        # 中国区1（杭州）------默认
    "cn2": "https://aws-openapi.guance.com",    # 中国区2（宁夏）
    "cn4": "https://cn4-openapi.guance.com",    # 中国区4（广州）
    "cn6": "https://cn6-openapi.guance.one",    # 中国区6（香港）
    "us1": "https://us1-openapi.guance.com",    # 海外区1（俄勒冈）
    "eu1": "https://eu1-openapi.guance.one",    # 欧洲区1（法兰克福）
    "ap1": "https://ap1-openapi.guance.one",    # 亚太区1（新加坡）
    "za1": "https://za1-openapi.guance.com",    # 非洲区1（南非）
    "id1": "https://id1-openapi.guance.com",    # 印尼区1（雅加达）
}

4、配置完 MCP 服务后，点击开启按钮

5、回到⾸⻚，选择话题或者助手中点击图标，选择刚刚创建的 MCP（这里以 MCP 服务器为例）

6、验证消息已确认是否接入了 MCP 服务

总结

大模型接入 MCP 服务的好处：

突破自身局限，既能获取训练数据之外的实时信息，也能安全调取企业私有数据，还能弥补复杂操作能力短板；
调用工具更高效，MCP 的统一标准省去逐个适配不同工具接口的麻烦，还能串联多个工具协同完成复杂任务；
降低开发与运维成本，开发者无需关注工具底层差异，可聚焦业务，同时多工具协作的问题也能通过标准化协议简化；
便于搭建应用生态，既能轻松接入现有各类 MCP 服务快速适配新场景，也能将自身特色能力封装成 MCP 服务供他人复用。