AdformMcp-MCP服务器
模型上下文协议（MCP）服务器，使AI助手能够直接获取和解析Confluence内容。
先决条件
获取您的Confluence API代币
- 访问 Atlassian API代币管理器
- 点击 “创建API令牌”
- 给它一个描述性标签（例如“MCP服务器”）
- 复制并保存生成的令牌 -您需要它进行配置
安装和权限
下载
- 去 发布 页
- 下载适用于Mac的二进制文件：
- 苹果硅（M1/M2/M3）: AdformMcp-osx-arm64.tar.gz - 英特尔Mac: AdformMcp-osx-x64.tar.gz
- 提取存档：
tar -xzf AdformMcp-osx-arm64.tar.gz- 移动到永久位置：
mkdir -p ~/bin
mv AdformMcp ~/bin/
chmod +x ~/bin/AdformMcp- MacOS权限
xattr -dr com.apple.quarantine ~/bin/AdformMcp用法
配置格式
将此配置添加到MCP客户端设置中：
{
"adform-mcp-server": {
"command": "/absolute/path/to/AdformMcp",
"args": [],
"env": {
"CONFLUENCE_EMAIL": "your.email@example.com",
"CONFLUENCE_TOKEN": "your-api-token-here"
}
}
}设置步骤
- 找到MCP客户端的配置文件（请参阅编辑的MCP文档）
- 将上述配置与您的实际值相加：
- 替换 /absolute/path/to/AdformMcp 使用二进制文件的完整路径（例如。， /Users/yourusername/bin/AdformMcp) - 替换 your.email@example.com 通过您的Adform电子邮件 - 替换 your-api-token-here 使用系统必备中的API令牌
- 重新启动编辑器/MCP客户端
- 通过询问您的AI助手进行验证： *“Ping Adform Confluence服务器”*
- 预期响应：“Pong”
寻找绝对路径
要获取二进制文件的完整路径：
# If you placed it in ~/bin/
realpath ~/bin/AdformMcp
# Or use pwd if in the same directory
pwd # Then append /AdformMcp可用工具
GetAmplitudeInstruction
获取振幅跟踪实施指南和说明。
参数： 无
例子： *“获取振幅跟踪实施指南”*
退货： 完整的指南，包括如何实施振幅跟踪的说明
GetAmplitudeData
按ID从Confluence页面获取并解析振幅事件数据。
参数：
id（字符串）：汇流页ID
例子： *“从Confluence页面123456789获取振幅数据”*
退货： 从指定汇流页面解析振幅数据表
ImplementAmplitudeEvents
通过将指令指南与Confluence页面中的振幅数据相结合来实现振幅事件。
参数：
id（字符串）：汇流页ID
例子： *“执行汇流页123456789中的振幅事件”*
退货： 组合实施指南和Amplitude事件数据已准备好实施。此工具会自动从Confluence页面获取指令指南和特定事件数据。
故障排除
| 问题 | 解决方案 |
|---|---|
| “权限被拒绝” | 运行 chmod +x /path/to/AdformMcp |
| “CONFLUENCE_EMAIL未设置” | 验证 env 配置中的部分同时包含电子邮件和令牌 |
| 未检测到服务器 | 使用绝对路径（例如。， /Users/name/bin/AdformMcp)，不 ~/bin/AdformMcp |
| 错误的架构 | 请与联系 uname -m：使用 arm64 或 x86_64 相应版本 |
| 令牌过期 | 从Atlassian重新生成新的API令牌 |
| 网络问题 | 确保您可以访问 https://adform.atlassian.net |
环境变量
服务器需要这些环境变量（在 env 部分）：
CONFLUENCE_EMAIL：您的Adform Confluence电子邮件地址CONFLUENCE_TOKEN：您的Atlassian API代币
许可证
内部Adform工具。