使用说明
Tines MCP服务器
用于与Tines安全自动化平台交互的模型上下文协议(MCP)服务器。
特性
- 故事:列出、创建、更新、删除、导入/导出故事
- 行动:在故事中创建、更新、删除和运行操作
- 凭证:管理文本和OAuth凭据
- 团队和文件夹:组织您的Tines工作区
- 事件:查看故事执行历史记录
- 全球资源:跨故事管理共享资源
安全
- API令牌存储在
.env文件(从未提交到git) - 所有API调用都使用HTTPS
- 对错误消息进行清理,以防止令牌泄漏
- 所有参数的输入验证
设置
1.克隆存储库
git clone https://github.com/YOUR_USERNAME/tines-mcp-server.git
cd tines-mcp-server
2.安装依赖项
pip install -r requirements.txt
3.配置凭据
复制示例环境文件:
cp .env.example .env
编辑 .env 使用您的Tines凭据:
TINES_TENANT=your-company.tines.com
TINES_API_TOKEN=your-api-token-here
获取API令牌:
- 登录Tines
- 转到您的个人资料(右上角)
- 导航到 API令牌
- 创建具有适当权限的新令牌
- 立即复制令牌(不会再次显示)
4.配置克劳德桌面
将此添加到您的Claude Desktop配置文件中:
视窗: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"tines": {
"command": "python",
"args": ["/path/to/tines-mcp-server/server.py"]
}
}
}
备注:更新路径以匹配您的实际安装位置。
5.重新启动克劳德桌面
配置后,重新启动Claude Desktop以加载MCP服务器。
可用工具
故事
| 工具 | 说明 |
|---|---|
list_stories |
列出所有故事 |
get_story |
获取故事详情 |
create_story |
创建新故事 |
update_story |
更新故事 |
delete_story |
删除故事 |
export_story |
将故事导出为JSON |
import_story |
从JSON导入故事 |
行动
| 工具 | 说明 |
|---|---|
list_actions |
列出故事中的动作 |
get_action |
获取操作详细信息 |
create_action |
创建新操作 |
update_action |
更新操作 |
delete_action |
删除操作 |
run_action |
手动触发操作 |
凭证
| 工具 | 说明 |
|---|---|
list_credentials |
列出所有凭据 |
get_credential |
获取凭证详细信息 |
create_text_credential |
创建文本凭据 |
create_oauth_credential |
创建OAuth凭据 |
delete_credential |
删除凭据 |
团队和文件夹
| 工具 | 说明 |
|---|---|
list_teams |
列出所有团队 |
get_team |
获取团队详细信息 |
list_folders |
列出所有文件夹 |
get_folder |
获取文件夹详细信息 |
create_folder |
创建新文件夹 |
事件
| 工具 | 说明 |
|---|---|
list_events |
列出故事事件 |
get_event |
获取活动详细信息 |
全球资源
| 工具 | 说明 |
|---|---|
list_global_resources |
列出所有全球资源 |
get_global_resource |
获取资源详细信息 |
create_global_resource |
创建资源 |
update_global_resource |
更新资源 |
delete_global_resource |
删除资源 |
公用事业
| 工具 | 说明 |
|---|---|
list_action_types |
列出可用的操作类型 |
草稿(变更控制)
对于启用了更改控制的故事,请使用这些工具安全地创建、测试和发布更改:
| 工具 | 说明 |
|---|---|
list_drafts |
列出故事的所有草稿 |
get_draft |
获取草稿详细信息 |
create_draft |
根据现场故事创建新草稿 |
delete_draft |
放弃草稿 |
publish_draft |
将草稿发布到实时 |
list_draft_actions |
在草稿中列出操作 |
create_draft_action |
在草稿中添加操作 |
update_draft_action |
更新草案中的行动 |
delete_draft_action |
从草稿中删除操作 |
run_draft_action |
测试草稿中的动作 |
变更控制工作流程:
create_draft-根据现场故事创建草稿create_draft_action/update_draft_action-进行更改run_draft_action-测试您的更改publish_draft-推动更改生效(或delete_draft丢弃)
常见操作类型
创建操作时,请使用以下类型字符串:
| 类型 | 描述 |
|---|---|
Agents::HTTPRequestAgent |
发出HTTP请求 |
Agents::EventTransformationAgent |
转换事件数据 |
Agents::TriggerAgent |
计划触发 |
Agents::WebhookAgent |
接收webhooks |
Agents::SendToStoryAgent |
将数据发送到另一个故事 |
Agents::EmailAgent |
发送电子邮件 |
Agents::IMAPAgent |
接收电子邮件 |
Agents::JavaScriptAgent |
运行JavaScript代码 |
Agents::PythonAgent |
运行Python代码 |
示例用法
配置后,您可以要求Claude:
- “列出我所有的Tines故事”
- “创建一个名为“网络钓鱼响应”的新故事”
- “将HTTP请求操作添加到故事ID 123”
- “向我展示故事456的事件”
- “导出故事789,这样我就可以支持它了”
许可证
麻省理工学院