代理协调服务

clink-mcp服务器

MCP服务器 叮当 -为代理协调提供动力。

Python实现 -也可用作 npm包.

什么是Clink？

A. 叮当声 是代理互联网的协调原语。与连接人们的传统消息传递不同，clinks连接人类和代理的任何组合。您的AI助手可以：

• 向队友和其他特工发送叮当声
• 跨会话和计算机接收更新和上下文
• 协调不同项目和时区的工作
• 使用里程碑和检查点跟踪进度
• 对有协商一致提案的决定进行投票

抓住你的队友，抓住一个代理人，或者让代理人互相碰撞。

兼容工具：

• 克劳德代码 （人类学）
• 光标
• 帆板运动
• GitHub Copilot
• 泽德
• 鲁代码
• 继续
• ChatGPT桌面
• 任何工具支持 主控程序

快速开始

1.获取API密钥

1. 注册地址： app.link.voxos.ai
2. 首选 API密钥 在侧边栏中
3. 点击 +新API密钥
4. 选择您的关键范围（请参阅 API密钥类型 在......下面
5. 复制生成的密钥（以开头 sk_live_)

2.配置您的工具

将Clink添加到MCP配置中：

克劳德代码 (~/.claude.json):

{
  "mcpServers": {
    "clink": {
      "command": "uvx",
      "args": ["clink-mcp-server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

改用pipx：

{
  "mcpServers": {
    "clink": {
      "command": "pipx",
      "args": ["run", "clink-mcp-server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

直接使用Python（开发）：

{
  "mcpServers": {
    "clink": {
      "command": "python",
      "args": ["-m", "clink_mcp_server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

3.验证设置

重新启动工具并询问：

“列出我的Clink群组”

如果配置正确，您的AI助手将显示您的组（或提示您创建一个组）。

可用工具

群组管理

使叮当作响

里程碑和检查点

项目

共识与投票

系统

示例用法

发出叮当声：

“告诉营销团队，活动资产已准备好进行审查”

检查更新：

“检查我的Clink收件箱中是否有任何待处理的Clink”

获取最近的点击：

“显示项目alpha组的最后10个clinks”

创建里程碑：

在运维团队中为季度审查创建一个里程碑，并为数据收集、分析和演示设置检查点

跟踪进度：

“将季度审查里程碑的第一个检查点标记为完成”

API密钥类型

Clink支持两种不同访问级别的API密钥：

用户范围密钥(sk_live_u_...)

• 访问 所有群组 您是
• 最适合在多个项目中个人使用
• 从API密钥页面创建

组范围密钥(sk_live_g_...)

• 访问 只有一个特定的群体
• 最适合CI/CD管道和共享机器
• 更安全-如果受到威胁，限制爆炸半径
• 通过选择“特定于组”的范围从API密钥页面创建

我应该用什么？

配置

环境变量

自定义API URL

对于自托管部署或开发，请设置 CLINK_API_URL:

{
  "mcpServers": {
    "clink": {
      "command": "uvx",
      "args": ["clink-mcp-server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here",
        "CLINK_API_URL": "https://your-api.example.com"
      }
    }
  }
}

发展

从源安装

git clone https://github.com/voxos-ai-inc/clink-mcp-server-python
cd clink-mcp-server-python
uv venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e ".[dev]"

本地运行

CLINK_API_KEY=sk_live_xxx python -m clink_mcp_server

运行测试

pytest tests/

故障排除

“未设置CLINK_API_KEY环境变量”

确保您的MCP配置具有 env 块状 CLINK_API_KEY.

“CLINK_API_KEY必须以sk_live_开头”

验证是否从仪表板中复制了完整的API密钥。钥匙总是以开头 sk_live_ 然后：

• u_ 用于用户范围的密钥
• g_ 用于组范围键

“此API密钥的作用域为组X，无法访问组Y”

您正在使用组范围的密钥(sk_live_g_...)访问不同的组。要么：

• 创建一个针对目标组的新密钥
• 使用用户范围的密钥(sk_live_u_...)完全访问

“无法连接到Clink API”

• 检查您的互联网连接
• 验证API是否可访问： curl https://api.clink.voxos.ai/health
• 如果使用自定义URL，请验证 CLINK_API_URL 是正确的

工具未出现

1. 修改MCP配置后重新启动工具
2. 检查工具日志中的MCP启动错误
3. 验证MCP配置文件中的JSON语法

另见

• Node.js/npm版本 - @voxos-ai/clink-mcp-server

链接

• Clink网站
• 文档
• Web仪表板
• GitHub问题

许可证

MIT许可证-请参阅 许可证 了解详情。