Prerequisites
- Claude Code CLI installed
- A Grapevine tenant
Setup with OAuth (Recommended)
1
Add the MCP server
Run the following command to add the Grapevine MCP server:
2
Authenticate
Launch
claude, and run /mcp. Navigate to the grapevine server then “Authenticate”
Your browser will open to authenticate you with Grapevine. Make sure to login using the same account you use to access your Grapevine dashboard.3
Confirm Tools are available
Run
/mcp again and confirm that you see the status is connected and authenticated. The Grapevine MCP tools should now be available to your Claude instance.Setup with API Key
If you don’t want to handle interactive authentication (e.g. you’re running Claude in a script, or you’re develpoing on a remote server without a browser), you can use an API key instead.1
Create an API key
Navigate to the API Keys page in the Grapevine admin dashboard and create a new API key. For more information on API keys, see the authentication guide.
2
Add the MCP server
Run the following command to add the Grapevine MCP server with your API key:Make sure to replace
YOUR_API_KEY with your actual API key.3
Confirm Tools are available
Run
/mcp in claudeand confirm that you see the status is connected and authenticated. The Grapevine MCP tools should now be available to your Claude instance.