Skip to main content

​
Setting Up the Gumnut MCP Server

This guide walks you through configuring the Gumnut MCP server in popular AI tools.

​
Prerequisites

  1. A Gumnut account
  2. An MCP-compatible tool

​
Server URL

The Gumnut MCP server is available at: 
https://api.gumnut.ai/mcp

​
Claude Code

Claude Code supports MCP servers natively through CLI commands or configuration files. When you connect, you’ll be prompted to authenticate with your Gumnut account via OAuth. Add the Gumnut MCP server with a single command: 
claude mcp add --transport http gumnut https://api.gumnut.ai/mcp
To make it available across all projects, add the --scope user flag: 
claude mcp add --transport http gumnut https://api.gumnut.ai/mcp --scope user

​
Using JSON Configuration

Alternatively, add the configuration directly to your ~/.claude.json file: 
{
  "mcpServers": {
    "gumnut": {
      "type": "http",
      "url": "https://api.gumnut.ai/mcp"
    }
  }
}
For project-specific configuration, create a .mcp.json file in your project root with the same structure.
You can also authenticate with an API key instead of OAuth by adding an Authorization header:
claude mcp add --transport http gumnut https://api.gumnut.ai/mcp \
  --header "Authorization: Bearer apikey_YOUR_API_KEY"
Or in JSON configuration:
{
  "mcpServers": {
    "gumnut": {
      "type": "http",
      "url": "https://api.gumnut.ai/mcp",
      "headers": {
        "Authorization": "Bearer apikey_YOUR_API_KEY"
      }
    }
  }
}

​
Verify Installation

Check that the server is configured: 
claude mcp list
You can also use the /mcp command within Claude Code to see available servers and their tools.

​
Cursor

Cursor supports MCP servers through JSON configuration files. When you connect, you’ll be prompted to authenticate with your Gumnut account via OAuth.

​
Configuration File Location

  • Global (all projects): ~/.cursor/mcp.json
  • Project-specific: .cursor/mcp.json in your project root

​
Configuration

Create or edit the configuration file: 
{
  "mcpServers": {
    "gumnut": {
      "url": "https://api.gumnut.ai/mcp",
      "transport": "http"
    }
  }
}

​
Using Cursor Settings UI

  1. Open Cursor and go to File > Preferences > Cursor Settings
  2. Select the MCP tab
  3. Click Add Server
  4. Enter the server details:
    • Name: gumnut
    • URL: https://api.gumnut.ai/mcp
    • Transport: http
You can also authenticate with an API key instead of OAuth by adding an Authorization header to the configuration:
{
  "mcpServers": {
    "gumnut": {
      "url": "https://api.gumnut.ai/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer apikey_YOUR_API_KEY"
      }
    }
  }
}

​
Verify Installation

After configuration, go to Cursor Settings > MCP to see gumnut listed as a registered server. Click refresh if needed.

​
Claude Web (claude.ai)

Claude on the web supports remote MCP servers through the Integrations feature.
MCP integrations on Claude.ai require a paid plan (Pro, Max, Team, or Enterprise). Free accounts cannot connect to MCP servers—use Claude Code or Claude Desktop instead.

​
Setup Steps

  1. Go to claude.ai and sign in
  2. Click Customize then Connectors (or go directly to claude.ai/customize/connectors)
  3. Click + to add a new connector
  4. Enter the Gumnut MCP server URL: 
    https://api.gumnut.ai/mcp
  5. You’ll be prompted to authenticate with your Gumnut account via OAuth
  6. Save the connector

​
Using the Integration

Once configured, you can ask Claude to interact with your Gumnut library directly in chat: 
"Show me all my photo albums"
"Find photos from last month"
"Create an album called 'Favorites'"

​
ChatGPT

ChatGPT supports MCP servers through custom apps.
Gumnut will be added to the ChatGPT app store in the near future. In the meantime, you can connect manually using developer mode.

​
Setup Steps

  1. Open ChatGPT and go to Settings > Apps (or go directly to chatgpt.com/#settings/Connectors)
  2. Enable Developer mode
  3. Click Create app
  4. Configure the app:
    • Name: Gumnut
    • Server URL: https://api.gumnut.ai/mcp
  5. You’ll be prompted to authenticate with your Gumnut account via OAuth
  6. Save the app

​
Using Gumnut in ChatGPT

Once configured, you can ask ChatGPT to interact with your Gumnut photo library directly in chat.

​
Troubleshooting

Having issues? See the MCP Troubleshooting guide for common problems and solutions.

​
Next Steps

Once configured, you can interact with your Gumnut photo library through natural language. See the MCP Overview for example interactions and available operations.