Shared Lists MCP Bridge

This bridge allows Claude Desktop to communicate with the Shared Lists MCP HTTP server.

Installation

1. Install dependencies:

cd mcp-bridge
npm install

2. Make the script executable:

chmod +x index.js

Configuration

For macOS:

1. Open Claude Desktop config file:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add this configuration:

{
  "mcpServers": {
    "sharedlists": {
      "command": "node",
      "args": ["/Users/stephanmethner/AR/sharedata-web/mcp-bridge/index.js"],
      "env": {
        "MCP_SERVER_URL": "https://0a820d7112fb.ngrok.app/api/mcp/v1",
        "MCP_TOKEN": "sk_live_zPgjL2lTFuuMXVjIxxknTHSRfgISh6kT"
      }
    }
  }
}

3. Restart Claude Desktop

For Windows:

1. Open Claude Desktop config file at:

%APPDATA%\Claude\claude_desktop_config.json

2. Add the same configuration (adjust the path to use Windows format)

Testing

To test the bridge manually:

cd mcp-bridge
MCP_SERVER_URL="https://0a820d7112fb.ngrok.app/api/mcp/v1" \
MCP_TOKEN="sk_live_zPgjL2lTFuuMXVjIxxknTHSRfgISh6kT" \
node index.js

Using with Claude Desktop

Once configured, you can ask Claude:

• "What lists do I have?"
• "Read data from list [listId]"
• "Update cell A1 in list [listId] to 'New Value'"
• "Search for 'customer' in list [listId]"

Troubleshooting

1. Check Claude Desktop logs:

   • macOS: ~/Library/Logs/Claude/
   • Windows: %APPDATA%\Claude\logs\

2. Bridge logs are written to stderr and will appear in Claude's logs

3. Common issues:

   • Ensure the path to index.js is absolute
   • Check that the MCP server URL is accessible
   • Verify the token is valid