使用说明
Azure 逻辑应用程序 MCP 服务器
通过模型上下文协议(MCP),将Azure逻辑应用工作流转换为AI助手可用的工具。
让人工智能代理来做这项工作
别把整个README文件都读完! 只需下载 AGENTS.md 翻译为中文是:“代理.md” 或者 “代理商文件.md”(具体翻译可能根据上下文有所调整,但“md”通常表示Markdown格式的文件)。在这里,“AGENTS”可能指的是代理或代理商的列表或说明,“.md”表示这是一个使用Markdown语言编写的文件 并将其交给一个人工智能代理。
然后说: “将我的Azure逻辑应用设置为MCP服务器”
代理会处理一切事宜:
- 请求您的Azure资源
- 配置MCP端点
- 设置身份验证(开发或生产环境)
- 创建你的第一个工具
- 连接到VS Code或Claude
无依赖项。无脚本。只需一个AGENTS.md文件和一个人工智能代理。
还是想手动操作吗?请继续阅读。。。
手动设置(如您所愿)
先决条件
1. 在您的逻辑应用中启用MCP
# Set your values
export SUBSCRIPTION_ID="your-subscription-id"
export RESOURCE_GROUP="your-resource-group"
export LOGIC_APP_NAME="your-logic-app-name"
# Login and get token
az login
TOKEN=$(az account get-access-token --resource https://management.azure.com --query accessToken -o tsv)
# Get Kudu URL
KUDU_URL=$(az logicapp show \
--name $LOGIC_APP_NAME \
--resource-group $RESOURCE_GROUP \
--query "enabledHostNames[?contains(@, 'scm')]|[0]" \
-o tsv)
# Create host.json
cat > host.json <<'EOF'
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
"version": "[1.*, 2.0.0)"
},
"extensions": {
"workflow": {
"McpServerEndpoints": {
"enable": true,
"authentication": {
"type": "anonymous"
}
}
}
}
}
EOF
# Upload and restart
curl -X PUT "https://${KUDU_URL}/api/vfs/site/wwwroot/host.json" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "If-Match: *" \
--data-binary @host.json
az logicapp restart --name $LOGIC_APP_NAME --resource-group $RESOURCE_GROUP
等待30秒后重新启动。
2. 创建你的第一个工具
3. 连接至AI助手
VS Code(推荐):
- 命令面板 → “MCP:添加服务器”
- 输入:
https://your-logic-app-name.azurewebsites.net/api/mcp - 您的工具会自动出现
Claude Desktop(桌面版)
{
"mcpServers": {
"logic-apps": {
"url": "https://your-logic-app-name.azurewebsites.net/api/mcp",
"transport": "streamable-http"
}
}
}
MCP检查员:
npx @modelcontextprotocol/inspector
# URL: https://your-logic-app-name.azurewebsites.net/api/mcp
# Transport: Streamable HTTP
创建工具
每种工具都是一个 无状态的 或者 有状态的 与……的工作流程:
- HTTP 请求触发器 (命名为“manual”)并带有JSON模式
- 业务逻辑 (任何工作流操作)
- HTTP 响应 (200 状态码,JSON 格式的响应体)
如需完整的流程模板和示例,请参阅 AGENTS.md 翻译为中文是:“代理列表/说明.md”(注:这里的“AGENTS”通常指的是代理或代表,“.md”是Markdown文件格式的后缀,表示这是一个Markdown格式的文件,可能包含代理的列表、说明或相关配置)。
用例
- 数据集成查询数据库、API、Azure服务
- 业务自动化触发工作流,发送通知
- 数据转换转换格式,处理数据
- 自定义操作执行特定的业务逻辑
生产安全
快速入门使用 匿名认证 用于开发/测试。
用于生产配置OAuth 2.0认证:
- 行业标准的安全性
- Azure AD 集成
- 基于用户的访问控制
- 基于作用域的权限
见 AGENTS.md 翻译为中文是:“代理.md”(注:这里的“.md”通常表示Markdown文件格式,但在中文语境下,我们通常直接保留“.md”以指明文件类型,不直接翻译)。所以,完整的翻译可以是“代理(Markdown文件)”。不过,根据上下文,有时也可能简化为“代理文件”来指代这类文件 包含完整的OAuth 2.0设置说明:
- Azure AD 应用注册
- 简易身份验证配置
- VS Code 自动发现支持
- 故障排除指南
注: VS Code 1.102+ 自动发现 OAuth 设置 - 只需添加服务器 URL 并登录!
故障排除
工具未出现:
- 验证工作流程是否已纳入
<tool-name>/workflow.json - 检查
"kind": "Stateless"被设置 - 重启逻辑应用并等待30秒
认证错误:
- 验证
authentication在里面McpServerEndpoints在 host.json 中 - 配置更改后重启逻辑应用
如需详细的故障排除和自动化部署信息,请参阅 AGENTS.md 翻译为中文是:“代理列表.md” 或 “代理说明文件.md”(具体翻译可能根据上下文有所调整,但“AGENTS”通常指的是“代理”的意思,“.md”是Markdown文件格式的扩展名)
资源
许可证
麻省理工学院(MIT)
