Connect Grigora MCP with Claude Code

This guide explains how to connect Grigora MCP with Claude Code. We'll show you how to add the Grigora remote MCP server, authenticate your Grigora account, authorize access, and verify that the connection is working.

Prerequisites

Before you begin, make sure you have:

Claude Code installed and configured.
A Grigora account with access to at least one site.
An active internet connection.

Step 1: Open Claude Code

Open your terminal and start Claude Code by running:

claude

Claude Code terminal showing an MCP server that needs authentication.

Step 2: Add the Grigora MCP Server

Run the following command in your terminal:

claude mcp add --transport http grigora https://mcp.grigora.co/mcp

This adds Grigora as a remote HTTP MCP server. HTTP is the recommended transport for remote MCP servers in Claude Code. (Claude)

Terminal command adding Grigora as an HTTP MCP server in Claude Code.

Step 3: Verify the MCP Server

After adding Grigora, run:

claude mcp list

You should see grigora listed among the configured MCP servers. (Claude)

Claude Code MCP server list showing Grigora awaiting authentication.

Step 4: Open the MCP Management Panel

Inside Claude Code, run:

/mcp

The MCP panel allows you to view the configured servers and manage their authentication and connection status. (Claude)

Claude Code Manage MCP servers panel showing server connection and authentication states.

Step 5: Authenticate with Grigora

After allowing the connection, Claude will start the Grigora authentication flow and open your browser.

Continue with the authentication process to connect your Grigora account.

Grigora consent page with the Continue button for Claude Code authorization.

Step 6: Authorize Access

After reviewing the selected site(s) and permissions, click Authorize to grant Claude Code access to Grigora MCP.

Grigora site selector and Authorize button for the Claude Code connection.

Step 7: Confirm the Connection

After authorization is complete, return to Claude Code and open:

/mcp

The grigora server should now show as connected, with its available tools displayed. The /mcp panel shows the tool count for connected servers. (Claude)

Grigora marked connected with its tool count in Claude Code.

Step 8: Test Grigora MCP

Send a prompt in Claude Code that requires access to your Grigora account.

For example:

Show me the projects available in my Grigora account.

Claude Code should use the connected Grigora MCP tools to retrieve the requested information.

Claude Code response listing projects from the connected Grigora account.

Troubleshooting

If Grigora MCP doesn't connect or its tools aren't available:

Verify that the configured URL is exactly:
https://mcp.grigora.co/mcp
Run claude mcp list to confirm that Grigora is configured.
Run /mcp inside Claude Code and check the Grigora connection status.
If authentication is required again, select Grigora in /mcp and authenticate again.
If the browser doesn't open automatically, Claude Code provides a URL that you can open manually. (Claude)
If authentication succeeds but Claude Code doesn't recognize the connection, reload or restart Claude Code.
If the problem persists, use the Clear authentication option in the /mcp menu and authenticate Grigora again. (Claude)
Verify that you authorized the correct Grigora site.

Note: Claude Code stores authenticated credentials securely and can refresh OAuth tokens automatically. (Claude)

Optional: Project-specific configuration

If you want Grigora MCP to be available only for a particular project, Claude Code also supports project-scoped MCP servers. These are stored in a .mcp.json file in the project's root directory. (Claude)

For the general Grigora setup, however, the simple claude mcp add --transport http approach is cleaner and avoids unnecessary manual JSON configuration.