Copilot Studio MCP Fix

MCPAI代理

提供方 EgoManiac

AI代理 未标注 无需鉴权 社区 / 第三方 Claude

MCP协议是一种用于将大型语言模型连接到外部工具和服务的标准方式,本文介绍了在Power Automate自定义连接器中调试Python MCP服务器时遇到的问题及解决方案。

一句话选型结论

按资料字段整理

Copilot Studio MCP Fix 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP协议C#本地部署PowerAutomate调试工具Python服务器SSE转换

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Copilot Studio MCP Fix当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方EgoManiac上游标注的维护方 EgoManiac
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.1 KB
来自项目仓库与上游目录的原文,未做删改

为什么MCP很重要,为什么SSE让我们陷入困境——为什么更好的调试工具已经过期

Chris Burns(英国IT顾问)的电源自动化连接器故事

关键词: MCP协议、服务器发送事件(SSE)、Power Automation自定义连接器、Python MCP、调试、SSE转换


编辑: 这在Python MCP协议的1.12.2版本中已经修复。我将把它留在这里存档,并提醒自己如何在自定义连接器中使用代码功能

引言:宏观视角:MCP——类似于USB‑C,但适用于AI

MCP(模型上下文协议)正迅速成为将大型语言模型插入外部工具和服务的标准方式。把它想象成AI的USB-C——同样的插头,可以在任何地方使用。无论您是使用Claude、Copilot Studio还是滚动自己的Python服务器,MCP都为您提供了一种结构化的、基于JSON-RPC 2.0的方式,将函数、提示和资源公开给LLM。

Python是MCP服务器的首选:易于上手,文档记录合理,维护积极。因此,当我们需要通过SSE将Python MCP服务器连接到Power Automation自定义连接器时,我们认为这很简单。

剧透:不是。

Gotcha:当你的ID在飞行途中更改类型时

我们遇到了一个微妙但令人恼火的问题。

我们的电力自动化流程预期 id MCP响应中的字段作为 字符串,以符合我们连接器的OpenAPI模式。但是,默认情况下,Python MCP服务器会发出:```http
event: message
data: {"jsonrpc":"2.0","id":1,"result":{…}}


那个数字 `"id": 1` 下游架构验证失败,导致连接器错误。我们需要:```http
event: message
data: {"jsonrpc":"2.0","id":"1","result":{…}}

这很简单,但SSE格式的复杂性和自定义连接器脚本的约束使这成为一个更深层次的挑战。


SSE≠JSON——电力自动化不会告诉你

我们最初的天真实现只是通过以下方式将响应解析为JSON JObject.Parse(responseString) 并重写了它。不出所料,它以灾难性的失败告终。就在那时,我们意识到:

  • SSE响应使用基于线路的流媒体--event: 和 data: 行--不是纯JSON
  • 您必须手动解析出来 data:,转换JSON,并使用正确的标头重新构建

尽管微软自己的文档显示了使用MCP的SSE示例,但Power Automation连接器无法开箱即用。没有错误。没有警告。只是无声的失败。


社区智慧:什么帮助了我们

Power Platform社区是无价的。贡献者强调:

  • Power Automation强制执行严格的内容类型/模式验证
  • SSE必须逐行处理
  • Python MCP服务器ID是“当前”的数字,但MS客户端希望返回字符串ID——MCP规范没有明确规定“类型”应该相同。

GitHub MCP问题(#961)确认这是一个已知的不兼容性:Python MCP发出整数ID,与Copilot Studio的期望相冲突。


Power Automation的脚本黑盒

现在,让我们谈谈工具。

深入挖掘这一点,揭示了另一个主要的摩擦—— 调试不存在自定义连接器的代码编辑器:

  • 不支持单步调试
  • SSE管道内不会出现原木
  • 编译错误是模糊的,例如。 $"...” 字符串插值默默失败
  • 您无法查看请求/响应历史记录

这些限制意味着我们实际上是盲目的,猜测转换,并希望它们与模式规则保持一致。一个简单的控制台或通话记录查看器本可以为我们节省几个小时。


工作解决方案:代码示例+说明

这是最终可用的自定义连接器代码的关键代码片段——有关完整代码,请查看脚本文件:```csharp
//// Shortened - Ensure you use full script file attached

//......

HttpResponseMessage response = await this.Context.SendAsync(this.Context.Request, this.CancellationToken).ConfigureAwait(continueOnCapturedContext: false);

// Do the transformation if the response was successful, otherwise return error responses as-is
if (response.IsSuccessStatusCode)
{
var responseString = await response.Content.ReadAsStringAsync().ConfigureAwait(false);

// Split into lines
var lines = responseString.Split(new[] { '\n', '\r' }, StringSplitOptions.RemoveEmptyEntries);

string eventLine = null;
string dataLine = null;

foreach (var line in lines)
{
if (line.StartsWith("event:"))
{
eventLine = line;
}
else if (line.StartsWith("data:"))
{
dataLine = line;
}
}

if (dataLine != null)
{
var jsonPart = dataLine.Substring("data:".Length).Trim();

var result = JObject.Parse(jsonPart);

if (result["id"] != null)
{
result["id"] = result["id"].ToString();
}

// Reconstruct the SSE format
var rebuiltResponse = eventLine + "\n" +
"data: " + result.ToString(Newtonsoft.Json.Formatting.None) + "\n\n";

//_logger.LogInformation("Transformed SSE JSON: {rebuiltResponse}", rebuiltResponse);

response.Content = new StringContent(
rebuiltResponse,
System.Text.Encoding.UTF8,
"text/event-stream"
);
}
}

return response;

```

为什么有效:

  1. 仅提取SSE JSON有效负载
  2. 转换 id 到字符串
  3. 重建符合要求的输出

还缺少什么?更好的工具,微软!

如果微软希望开发人员构建更丰富的连接器,他们需要投资于基础:

  • SSE支持刚刚奏效
  • 一个合适的调试控制台(即使是只读日志也可以)
  • 编译时错误可见性
  • 打电话给历史记录,看看引擎盖下发生了什么

现在,我们正在盲目飞行。


最后总结

  1. SSE很特别;把它当作流媒体,而不是静态JSON
  2. Python MCP在技术上是规范正确的,但连接器消费者可能期望字符串而不仅仅是整数(在修复列表中)
  3. 社区事务。如果没有论坛和GitHub线程,我们仍然会猜测。
  4. 微软:把你的工具整理一下。这可能是一个出色的平台——如果我们能看看它在做什么。

感谢社区

非常感谢 CU24061549-1 和 FW‑24061242‑0 因为他们的早期见解。GitHub MCP编号问题(#961)澄清说,这不是一次性错误,而是规范级不匹配。


行动号召

  • 如果你在建 Python MCP服务器, SSE兼容性测试
  • 对于 电力自动化开发人员,分享您的连接器调试经验
  • 微软: 为我们提供更好的日志和断点拜托!

关于克里斯·伯恩斯\
来自英国的技术架构师和AI自动化设计机构所有者(Kaizenova/Nastar),专门从事Power Platform&Copilot Studio、Azure和AI集成。


发布时间:2025-07-09

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Copilot Studio MCP Fix 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Copilot Studio MCP Fix 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Copilot Studio MCP Fix 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Copilot Studio MCP Fix 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Copilot Studio MCP Fix 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Copilot Studio MCP Fix 能提供哪些能力?

资料显示能力标签包括 调试工具、C#、Claude、Python服务器。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。