公司MCP服务器
MCP（模型上下文协议）服务器 孔帕尼 -将Claude Code连接到您的任务管理和团队协作平台。
快速开始
将此添加到您的项目 .mcp.json:
{
"mcpServers": {
"kompany-cloud": {
"command": "uvx",
"args": ["--from", "git+https://github.com/gneyal/p_69_branch_kompany_mcp.git", "branch-monkey-mcp"],
"env": {
"BRANCH_MONKEY_API_URL": "https://kompany.dev"
}
}
}
}重新启动克劳德代码。首次使用时，浏览器将打开，供您登录并批准设备。
将其与Codex一起使用
Codex不像Claude Code那样使用MCP服务器，因此集成路径不同：
- 使用本地网桥和工作流CLI，而不是
.mcp.json - 将默认CLI提供程序设置为
codex - 通过以下方式验证Codex
OPENAI_API_KEY或codex login - 将MCP服务器作为Claude Code的可选适配器
在此仓库中，非MCP路径已存在：
- Kompany API逻辑是纯Python/HTTP，而不是特定于MCP的
- 本地代理服务器支持
cli_tool: "codex" kompany-workflow llm可以通过选定的CLI提供程序路由提示
这意味着实际的Codex适应是：将MCP视为一个前端，而不是核心架构。
特性
- 不需要API密钥 -通过浏览器批准进行身份验证
- 自动令牌存储 -保存在
~/.branch-monkey/token.json - 任务管理 -创建、更新、跟踪任务
- 团队协作 -与团队共享任务
- 快速跟踪 -将提示与任务相关联
可用工具
状态和身份验证
kompany_status-获取连接状态kompany_login-强制重新身份验证（如果存在身份验证问题，请使用）kompany_logout-清除身份验证令牌
项目和组织
kompany_project_list-列出组织中的所有项目kompany_project_focus-将重点放在特定项目上kompany_project_clear-明确项目重点kompany_org_list-列出您有权访问的组织
任务
kompany_task_list-列出所有任务kompany_task_create-创建新任务kompany_task_update-更新任务kompany_task_delete-删除任务kompany_task_work-开始处理任务kompany_task_log-记录任务的进度kompany_task_complete-将任务标记为已完成kompany_task_search-搜索任务kompany_get_recent_tasks-获取最近完成的任务kompany_auto_resume-自动检测相关任务
版本
kompany_version_list-列出版本kompany_version_create-创建版本
团队
kompany_team_list-列出团队成员kompany_team_add-添加团队成员
机器
kompany_machine_list-列出机器kompany_machine_create-创建一台机器
本地服务器标识
运行中继客户端时(branch-monkey-relay)，您的机器连接到Kompany Cloud并可用于执行任务。
机器识别的工作原理
每台本地机器都由一个唯一的 机器ID 由以下部分组成：
- 主机名 （例如。，
my-macbook-pro) - 进程ID （例如。，
12345)
组合格式： my-macbook-pro-12345
这确保了：
- 每台机器都有一个全局唯一的标识符
- 同一台机器上的多个中继实例获得不同的ID
- 系统可以将请求路由到正确的机器
“本地”按钮如何映射到计算机
重要：API中的“机器”(/api/machines)是业务自动化流程，而不是物理计算机。本地计算机被单独跟踪为 计算节点 在 compute_nodes 桌子。
当您单击任务卡上的“本地”时，系统会将请求路由到计算节点：
- 每个用户都有计算节点 -每个用户连接的计算机都会被跟踪
user_id - 目前：首次可用 -系统使用用户连接的计算节点（如果多个节点在线，则行为取决于前端实现）
- 未来：明确选择 -用户界面可以显示一个下拉菜单，选择要使用的计算机
备注：任务的 machine_id 字段是指业务流程机器，而不是本地计算机。
多台计算机作为“本地”
如果您有多台计算机以同一用户身份登录：
- 每个都注册为计算节点 -存储在
compute_nodes独特的桌子machine_id（主机名pid） - 相同的Supabase通道前缀 -但每个都有一个独特的渠道：
relay:{user_id}:{machine_id} - 路由需要machine_id -云必须指定向哪个计算节点发送请求
- 状态跟踪 -心跳每25秒更新一次
last_heartbeat和status
计算节点数据
通过以下方式跟踪每台连接的计算机：
machine_id：唯一标识符（主机名pid）user_id：经过身份验证的用户name：计算机主机名node_type：“本地”status：“在线”或“离线”last_heartbeat：上次心跳的时间戳capabilities例如。，{"claude": true}
连接行为
- 同一台机器id重新连接：更新（更新现有行）
- 同一主机上的不同进程：创建新条目（不同的PID=不同的machine_id）
- 机器脱机：正常关机时状态更新为“脱机”
当前限制
前端需要处理用户连接了多台计算机的情况。选项：
- 在“本地”上运行之前显示计算节点选择器
- 默认为最近活动的计算节点
- 允许用户设置“主”计算节点
故障排除
身份验证问题
如果您在连接时遇到问题：
- 使用
kompany_login-通过浏览器强制重新验证 - 检查令牌文件 -储存于
~/.branch-monkey/token.json - 清除并重试 -使用
kompany_logout，然后重新启动Claude Code - 检查网络 -确保您可以访问https://kompany.dev
首次设置
首次使用时：
- 浏览器窗口会自动打开
- 登录Kompany（或创建帐户）
- 选择要连接的组织
- 收到提示时批准设备
- 返回克劳德代码-您已连接！
连接后，使用 kompany_project_list 查看可用项目和 kompany_project_focus 选择一个。
需求
- Python 3.10+
- 紫外线 包管理器
许可证
麻省理工学院