Skip to content

Installation

Get started with EcoSemantic in minutes. This guide will walk you through setting up the MCP server with Claude.ai.

Prerequisites

Before you begin, make sure you have:

  • Claude.ai Desktop App (version 0.7.0+)
  • EcoSemantic Account (Free tier available at ecosemantic.com)
  • API Token (Generated from your dashboard)

Step 1: Get Your API Token

  1. Sign up at ecosemantic.com
  2. Navigate to your Dashboard
  3. Go to Settings → API Tokens
  4. Click "Generate New Token"
  5. Copy your token (keep it secure!)

Step 2: Configure Claude Desktop

macOS

  1. Open Claude Desktop settings
  2. Navigate to the MCP Servers section
  3. Add EcoSemantic MCP server:
{
  "mcpServers": {
    "EcoSemantic": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.ecosemantic.com/mcp",
        "--header",
        "Authorization:Bearer your-api-token-here"
      ]
    }
  }
}

Configuration file location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Configuration file location: %APPDATA%\Claude\claude_desktop_config.json

Use the same JSON configuration as above.

Linux

Configuration file location: ~/.config/Claude/claude_desktop_config.json

Use the same JSON configuration as above.

Step 3: Restart Claude

  1. Quit Claude Desktop completely
  2. Relaunch the application
  3. Look for the 🔧 tools icon in the interface
  4. Verify EcoSemantic tools are available

Step 4: Test Your Setup

Try this query in Claude:

Search for electricity production activities in the Ecoinvent 3.9.1 database

If Claude responds with search results and uses the search_activities tool, you're all set!

Troubleshooting

Tools Not Showing Up

  • Verify your API token is correct
  • Check the configuration file path
  • Ensure Claude Desktop is fully restarted
  • Check Claude version (must be 0.7.0+)

Authentication Errors

  • Regenerate your API token in the dashboard
  • Update the token in your configuration file
  • Restart Claude Desktop

Need Help?

Contact support at [email protected]

Next Steps