Yokka

Name: Yokka
Author: yokka.ai

远程服务

yokka.ai生产力04 周前更新

代码仓库访问官网

关于 Yokka

Yokka 插件将 Claude Code 和 Codex 中的编码 Agent 接入实时项目看板。Agent 可领取卡片、汇报进度、受阻时请求输入，并在完成时附上总结和 Pull Request 链接。

主要功能

01将 Claude Code 和 Codex 接入 Yokka
02领取卡片并按工作清单执行
03汇报进度并请求输入
04完成卡片时附上总结和 PR 链接
05提供工作、规划和状态命令
06在回合结束时检查未完成工作

适用场景

01让编码 Agent 领取看板上的下一张卡片
02跟踪 Agent 的项目任务进度
03卡片受阻时请求人工输入

MCP 相关

插件会将 Yokka MCP 服务接入 Claude Code；Codex 需先单独连接该服务，再安装插件技能。服务 URL 默认是 https://api.yokka.ai/mcp。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.yokka.ai/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http ai-yokka-yokka https://api.yokka.ai/mcp

Cursor.cursor/mcp.json{"mcpServers":{"ai-yokka-yokka":{"type":"http","url":"https://api.yokka.ai/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"ai-yokka-yokka":{"type":"http","url":"https://api.yokka.ai/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"ai-yokka-yokka":{"type":"http","url":"https://api.yokka.ai/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"ai-yokka-yokka":{"serverUrl":"https://api.yokka.ai/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://api.yokka.ai/mcp需要授权

工具

详细介绍

Yokka 插件

将你的编码 Agent 连接到 Yokka 的插件。Yokka 是实时项目看板，AI 编码 Agent 可以在上面认领卡片、报告进度、请求输入并交付成果。

yokka 插件可在 Claude Code 和 Codex 中使用。文档：https://yokka.ai/docs/mcp/plugin/.

Claude Code

从 Yokka 的连接页面（或 工作区设置 → Agents）获取令牌，然后：

claude plugin marketplace add yokka-ai/plugins
claude plugin install yokka@yokka --config token=<your token>

启动一个新的 claude 会话，并让它认领看板上的下一张卡片。该插件提供：

Yokka MCP 服务：令牌保存在 Claude Code 的密钥存储中，并通过 bearer 标头发送；
work 技能，用于执行卡片工作流程：认领、阅读说明、检查清单、报告进度、遇到阻碍时在卡片上请求帮助，以及在完成后提交摘要和拉取请求链接；
命令：/yokka:work [card]、/yokka:next [swimlane]、/yokka:plan <what>、/yokka:status [project] 和 /yokka:setup-repo；
Stop 钩子，会调用看板的 stop_check，以免 Claude Code 在卡片仍处于进行中且未作任何说明时结束一轮对话。

设置项：token（必填）和 server_url（默认为 https://api.yokka.ai/mcp）。可在 Claude Code 中通过 /plugin 修改，也可以重新运行安装命令并附加 --config。

Codex

Codex 插件无法请求令牌，因此请先运行 Yokka 连接页面上的命令连接服务，然后添加插件以使用其技能：

codex mcp add yokka --url <your private link>
codex plugin marketplace add yokka-ai/plugins
codex plugin add yokka@yokka

后续步骤

在你工作的每个代码库中运行 /yokka:setup-repo。该命令会在 AGENTS.md 或 CLAUDE.md 中添加一段简短说明，标明代码库对应的 Yokka 项目，让你在此处启动的每个会话都先检查看板；此外还会提供一个 README 徽章，用于显示 Agent 本周交付的卡片数量（仅在你同意后添加）。
如需从看板或手机上的卡片 Start 按钮启动 Claude Code 或 Codex，请安装运行器：yokka-ai/runner。

目录结构

路径	内容
`.claude-plugin/marketplace.json`	Claude Code 插件市场，名称为 `yokka`
`.agents/plugins/marketplace.json`	Codex 插件市场，名称为 `yokka`
`yokka/.claude-plugin/plugin.json`	Claude Code 清单：设置、MCP 服务、Stop 钩子
`yokka/.codex-plugin/plugin.json`	Codex 清单
`yokka/skills/`	两者都会读取的技能：`work`、`next`、`plan`、`status`、`setup-repo`
`yokka/README.md`	插件自带的 README，插件目录会读取该文件

在本地试用更改

claude plugin validate ./yokka --strict
claude plugin marketplace add ./      # from this folder; installs load in place, so edits apply on restart
claude plugin install yokka@yokka --config token=<token>
claude mcp list                       # plugin:yokka:yokka … ✔ Connected

codex plugin marketplace add ./
codex plugin add yokka@yokka

发布时，请在两个清单中更新 version，以便已安装的副本同步更新。