@mlgraham/coderocket-mcp

MCP server for CodeRocket Deploy — AI-generated CI/CD workflows and AI code review, available as tools inside Claude Code.

Setup

Claude Code will never prompt you for your API key. This server reads it from the environment once at startup. Set it before you start Claude Code, or the tools will report that they are not configured.

1. Create an API key

Go to deploy.coderocket.com/settings → API Keys → Create Key. The key is shown once — copy it before leaving the page. If you lose it, you must revoke it and create a new one.

2. Export it to your shell profile

echo 'export CODEROCKET_API_KEY=crk_your_key_here' >> ~/.zshrc   # or ~/.bashrc
source ~/.zshrc

3. Restart Claude Code

Required. A running session will not pick up a newly exported variable.

4. Install the plugin

claude plugin marketplace add mlgraham/coderocket-plugin
claude plugin install coderocket@coderocket-marketplace

Then verify with /coderocket:status.

Tools

Tool	Purpose
deploy_repo	Generate a CI/CD workflow for a repository (polls until complete)
create_pr	Open a pull request with a generated workflow
list_repos	List your connected repositories
repo_details	Details and analysis status for one repository
list_reviews	List AI code reviews
get_review	Fetch a single review with its inline comments
account_status	Account tier, usage, and limits
generation_feedback	Report whether a generated workflow worked
health_check	Check API connectivity and that your key is valid

Configuration

Variable	Required	Default	Purpose
CODEROCKET_API_KEY	yes	—	Your crk_ API key
CODEROCKET_API_URL	no	https://deploy.coderocket.com/api/v1	Override the API endpoint
CODEROCKET_ALLOW_CUSTOM_API_URL	no	—	Set to 1 to permit a non-default host

CODEROCKET_API_URL is validated before use. Because every request carries your API key as a bearer token, the server accepts only the official host or loopback by default, requires HTTPS off loopback, and refuses to start on an unsafe value rather than starting up and sending your credentials somewhere unintended. Pointing at a self-hosted backend requires CODEROCKET_ALLOW_CUSTOM_API_URL=1, which also prints a warning naming the host.

Troubleshooting

Every tool says the key is not set. The variable was not present when Claude Code started. Confirm with echo $CODEROCKET_API_KEY in a new terminal, then fully restart Claude Code — not just the conversation.

"API key has been revoked." The key exists but was revoked. Create a new one in Settings, update your shell profile, and restart Claude Code.

"is not an allowed CodeRocket host." CODEROCKET_API_URL points somewhere unexpected. If you did not set it deliberately, unset it — something in your environment did, and it would have received your API key. If it is an intentional self-hosted backend, set CODEROCKET_ALLOW_CUSTOM_API_URL=1.

Links

• Web app
• Claude Code plugin
• Changelog: CHANGELOG.md, shipped inside this package

License

MIT