使用说明
基本能力
产品定位
Segment公共API MCP服务器是一个模型上下文协议（MCP）服务器，提供对Segment公共API端点的访问，作为AI助手（如Claude）的工具。
核心功能
- 提供对200多个Segment公共API端点的访问
- 自动请求验证
- 适当的认证头
- 错误处理和响应格式化
- 支持Segment OpenAPI规范中定义的所有参数
适用场景
- 通过AI助手管理和操作Segment的各种功能
- 列出Segment工作区
- 获取源和目的地的信息
- 创建受众和计算特征
- 管理用户权限
工具列表
- Segment公共API端点：提供对200多个Segment公共API端点的访问，支持自动请求验证、认证头、错误处理和响应格式化。
使用教程
使用依赖
- Node.js（v18或更高版本）
- npm
- 有效的Segment API令牌
安装教程
- 安装依赖
npm install
- 设置环境变量
export SEGMENT_API_TOKEN="your_segment_api_token_here"
- 构建项目
npm run build
调试方式
- 使用MCP检查器测试
SEGMENT_API_TOKEN="YOUR_PAPI_TOKEN" npx @modelcontextprotocol/inspector node build/index.js
- 运行可流式HTTP服务器
SEGMENT_API_TOKEN="YOUR_PAPI_TOKEN" npm start
# 或
SEGMENT_API_TOKEN="YOUR_PAPI_TOKEN" node build/index.js
- 在Claude Desktop中安装
- 定位Claude的配置文件
~/Library/Application Support/Claude/claude_desktop_config.json
- 添加MCP服务器
{
"mcpServers": {
"segment-public-api": {
"command": "node",
"args": ["/absolute/path/to/your/project/build/index.js"],
"env": {
"SEGMENT_API_TOKEN": "your_segment_api_token_here"
}
}
}
}
- 重启Claude Desktop
