Back to Home

Setup Guide

Install the Autonomy MCP Server in minutes. Works with Claude Desktop (Stdio mode) and ChatGPT (HTTP mode).

Interactive Installation Wizard

1
2
3
4
ModeCredentialsConfigVerify

Choose Installation Mode

Select how you want to run the Autonomy MCP Server.

Or follow the manual steps below

Quick Start (Claude Desktop)

For most users, we recommend Stdio mode with Claude Desktop for local development:

# Clone the repository
git clone https://github.com/yourusername/mcp-autonomy.git
cd mcp-autonomy

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# Add to Claude Desktop config
# See "Stdio Mode" section below

Prerequisites

Required

  • Node.js 18+ installed
  • GitHub Personal Access Token (with repo + read:org scopes)

Optional (for specific tools)

  • Vercel API Token (for deployment monitoring)
  • Google Service Account JSON (for Drive access)

Installation

1

Clone the Repository

git clone https://github.com/yourusername/mcp-autonomy.git
cd mcp-autonomy
2

Install Dependencies

npm install
3

Configure Environment Variables

Create a .env file in the project root:

# Required: GitHub API access
GITHUB_TOKEN=ghp_your_github_personal_access_token

# Optional: Vercel deployment monitoring
VERCEL_TOKEN=your_vercel_api_token
VERCEL_TEAM_ID=team_your_team_id (if using teams)

# Optional: Google Drive access
GOOGLE_CREDENTIALS='{"type":"service_account","project_id":"...","private_key":"..."}'

# Server configuration (HTTP mode only)
MCP_PORT=3005

💡 Tip: Get your GitHub token at github.com/settings/tokens/new

Stdio Mode (Claude Desktop)

Stdio mode runs the server locally and connects directly to Claude Desktop. Recommended for most users.

Configuration

Add to your Claude Desktop config file:

  • • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "autonomy": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-autonomy/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token",
        "VERCEL_TOKEN": "your_vercel_token",
        "GOOGLE_CREDENTIALS": "{\"type\":\"service_account\",...}"
      }
    }
  }
}

⚠️ Important: Use absolute paths. Restart Claude Desktop after saving the config.

HTTP Mode (ChatGPT / Remote)

HTTP mode runs the server as a web service. Use this for ChatGPT integration or remote access.

Start the Server

npm start

Server will run on http://localhost:3005 (or your configured MCP_PORT).

ChatGPT Integration

Add the server URL to your ChatGPT MCP configuration:

{
  "mcpServers": {
    "autonomy": {
      "url": "http://localhost:3005"
    }
  }
}

Verify Installation

Checklist

  • Config file saved in correct location
  • Claude Desktop restarted
  • Server appears in MCP menu (Stdio) or responds to HTTP requests
  • Test a tool (e.g., autonomy/list_prs)

✅ Success! You should now see "autonomy-mcp" in your Claude Desktop MCP servers list.

Troubleshooting

Server not showing in Claude Desktop

  • • Verify config file path is correct for your OS
  • • Check JSON syntax (use a validator)
  • • Ensure absolute paths (not relative)
  • • Restart Claude Desktop completely
  • • Check Claude Desktop logs for errors

Tools returning authentication errors

  • • Verify environment variables are set correctly
  • • Check GitHub token has required scopes (repo + read:org)
  • • For Google Drive, ensure service account JSON is valid
  • • Test API credentials directly with curl/Postman

HTTP mode not starting

  • • Check port 3005 (or MCP_PORT) is not in use
  • • Verify Node.js version is 18+
  • • Check for .env file typos
  • • Review server logs for specific errors

What's Next?

Now that you've installed the server, explore the tools and see what you can build.

API ReferenceView Examples