连接和使用 MCP 服务

Dora 支持 MCP（Model Context Protocol）集成，使建模工具能够与外部智能体、数据平台和上下游应用连接，把企业已有能力带入建模过程。本页说明 MCP 的适用场景、服务配置参数、典型集成场景和配置排查方法。

MCP 能解决什么

能力	说明
模型与外部工具互通	与分析工具、知识库、数据目录、SQL Agent 等系统交互，实现模型元数据的实时共享与调用
AI 增强交互	提供上下文通信接口，在建模、校验和优化过程中调用大模型或智能代理，实现自然语言建模、SQL 自动生成、语义检查
资源与工具统一管理	在建模界面直接调用外部资源（知识库、文档、数据标准库）和工具（数据质量检测、血缘分析），避免切换系统
模型驱动的自动化脚本生成	模型变更后自动触发 SQL 脚本、调度脚本的生成与下发，并与企业调度平台联动
上下游流程协同	模型完成后通过 MCP 将模型信息同步到数据地图、资产目录，或调用外部服务生成接口与报表
安全与可控调用	集成外部智能体时提供能力范围和权限限制，确保调用符合企业安全与合规要求

参数	说明
MCP 服务名称	自定义的服务名称，用于识别该连接
服务描述	该服务的功能说明
服务端点	MCP 服务的地址，目前仅支持 Streamable 接口，例如 `https://your.mcp/svr/streamable?token=1234567890`
请求头配置	自定义请求头，用于验证、鉴权等，例如 `{"Content-Type": "application/json", "User-Agent": "aic/1.0"}`
自定义设置	自定义参数，会透传到 MCP 服务器，例如 `{"description": "aic", "version": "1.0"}`
启用状态	控制是否启用该服务连接
连接超时	默认 30000ms（30 秒），建立连接的最大等待时间
请求超时	默认 60000ms（60 秒），单次请求处理的最大时间
最大重试次数	默认 3 次，连接失败时的自动重试次数

请求头中的认证信息按企业安全规范保管，不要写入服务名称、描述或普通对话。只有已启用且当前智能体获准使用的服务才会参与任务，工具分配见选择和配置智能体。

场景	说明
数据开发与版本管理	与 Git 等代码管理工具集成，实现 SQL 脚本版本控制、回滚与协作
数据标准落标与一致性	自动校验模型、表字段和指标是否符合企业数据标准，统一口径
数据安全分类与分级	对敏感数据分类分级，结合访问控制策略实现合规使用和共享
智能化数据治理辅助	提供数据质量检查、血缘分析和建模建议，帮助发现和优化数据资产问题

现象	排查顺序
连接测试失败	核对服务端点是否为 Streamable 接口；确认网络可达；按需调大连接超时
对话提示工具不可用	检查服务启用状态、当前智能体是否分配了该工具
请求频繁超时	调大请求超时时间；确认服务端负载和网络状况
重试后仍失败	核对最大重试次数设置，用服务方提供的独立工具验证服务可用性
鉴权失败	核对请求头 JSON 格式和认证信息是否正确、是否过期

使用外部工具前，确认当前模型和对话内容允许发送到该服务；外部工具返回结果不等于已修改模型，实际变更以模型树和变更记录为准。把 Dora 自身作为 MCP 服务提供给外部 Agent 调用的方式，见管理全局配置和审计记录。