Skip to content

Add comprehensive Codegen MCP documentation #1161

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

codegen-sh[bot]
Copy link
Contributor

@codegen-sh codegen-sh bot commented Jun 30, 2025

This PR adds comprehensive documentation for the Codegen Model Context Protocol (MCP) server, addressing the requirements in CG-18858.

What's Added

📚 New Documentation

  • docs/integrations/mcp.mdx: Complete MCP integration guide
  • Updated docs/docs.json: Added MCP to integrations navigation

🔧 Key Features Documented

  • CLI Command: Full documentation of the existing codegen mcp command
  • Transport Options: stdio (working) and HTTP (planned) with port configuration
  • Available Tools: All 6 MCP tools including generate_codemod, create_agent_run, etc.
  • Authentication: API key setup and configuration methods

🎯 Editor Integration Guides

  • Cursor: Step-by-step setup with both UI and manual configuration
  • Claude Desktop: Configuration file setup
  • Cline (VS Code): Extension configuration

📖 Comprehensive Sections

  • Prerequisites and installation
  • Quick start guide
  • Authentication setup
  • Available tools reference
  • Troubleshooting guide
  • Best practices
  • Real-world examples
  • Advanced configuration

Technical Details

The documentation covers the existing MCP server implementation:

  • Command: codegen mcp with --host, --port, --transport options
  • Default: stdio transport on localhost
  • HTTP: Planned feature (currently falls back to stdio)
  • Port Display: Shows configured port when using HTTP transport

Testing

✅ Verified codegen mcp command functionality
✅ Tested all command options and help text
✅ Confirmed stdio transport works correctly
✅ Validated HTTP transport shows correct port information

Impact

This documentation enables users to:

  • Set up MCP integration with popular AI editors
  • Access Codegen's tools directly from their development environment
  • Generate codemods and manage agent runs seamlessly
  • Troubleshoot common setup issues

Resolves CG-18858


💻 View my workAbout Codegen

- Create detailed MCP documentation at docs/integrations/mcp.mdx
- Add MCP to integrations section in docs.json navigation
- Document existing 'codegen mcp' CLI command and all available options
- Include step-by-step setup instructions for Cursor, Claude Desktop, and Cline
- Document all available MCP tools: generate_codemod, create_agent_run, get_organizations, etc.
- Add authentication guide with API key setup instructions
- Include troubleshooting section with common issues and solutions
- Provide best practices and real-world usage examples
- Document transport options (stdio, HTTP) and port configuration
- Add advanced configuration examples for custom setups

Resolves CG-18858
@codegen-sh codegen-sh bot requested review from codegen-team and a team as code owners June 30, 2025 02:11
Copy link
Contributor Author

codegen-sh bot commented Jun 30, 2025

I see a check failed - I'm on it! 🫡

💻 View my work

Copy link

codecov bot commented Jun 30, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

✅ All tests successful. No failed tests found.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- Remove trailing whitespace on line 38
- Remove extra newline at end of file
- Fixes pre-commit check failures
Copy link
Contributor Author

codegen-sh bot commented Jun 30, 2025

✅ Fixed the failing pre-commit check in commit 68e0f81.

Issue: The pre-commit check was failing due to formatting issues in the MCP documentation file.

Fix:

  • Removed trailing whitespace on line 38 in docs/integrations/mcp.mdx
  • Removed extra newline at the end of the file

The changes have been pushed to the PR branch and should now pass the pre-commit checks.

💻 View my work

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant