Any agent that speaks MCP can work Alabasta tasks. Copy the prompt below into your agent and it makes the connection itself — after that, every delegated task ends with a reviewable record instead of a chat log.
Generate an API key
In Alabasta, open Workspace settings → Agent access and click Generate. The key is shown once — copy it somewhere safe. It acts with your membership, so work the agent submits is attributed to you, and you can revoke it at any time from the same page.
Connect your agent
Paste this into Claude Code, Codex, or any agent that can run commands and edit files — it registers the Alabasta MCP server for you, no terminal fiddling required:
Prefer to do it yourself? Run the command directly, or — for Claude Code — install the plugin instead, which bundles the same server with the resolution skill and a Stop hook that makes sure a resolution is filed before the agent finishes.
claude mcp add alabasta \ --env ALABASTA_SITE_URL=https://fearless-warthog-265.eu-west-1.convex.site \ --env ALABASTA_API_KEY=alab_sk_... \ -- npx -y @alabasta/mcp
/plugin marketplace add cowboyshibuya/alabasta-agent-bridge /plugin install alabasta@alabasta
[mcp_servers.alabasta]
command = "npx"
args = ["-y", "@alabasta/mcp"]
env = { ALABASTA_SITE_URL = "https://fearless-warthog-265.eu-west-1.convex.site", ALABASTA_API_KEY = "alab_sk_..." }
enabled = trueThe same resolution skill and Stop-hook enforcement are available for Codex — see the agent bridge repository for the two config files to copy.
Work a task
Start a session bound to a task — the launcher fetches it, pins the ids, and primes the agent:
alabasta work ALA-482 --agent claude
Or simply mention a task id in any session. Either way the agent reads the task before touching code, marks it in progress, and tracks what it changes and verifies as it works.
Review the resolution
When the agent finishes, it files a structured resolution — changed files, verification, what wasn’t verified, deferred work, and the real Git and CI state — and the task moves to To review. Accept it to mark the task done, or request a follow-up with a note and the agent picks it back up. Your task description is never rewritten, and nothing reaches Done without a human.
ALABASTA_SITE_URL— Your workspace's API origin — shown in the snippets above.ALABASTA_API_KEY— The key from Workspace settings → Agent access. Treat it like a password.ALABASTA_TASK_ID— Optional. Pins the session to one task so tools work without arguments.ALABASTA_RUN_ID— Optional. Lets a retried session update its resolution instead of duplicating it.
