Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@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/settingsAPI KeysCreate 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

License

MIT

About

MCP server for CodeRocket — AI-powered CI/CD generation and code review from Claude Code

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages