1. In Affogata, click your account icon top right, choose Settings, then MCP API key in the left menu. Under Install the MCP bundle in Claude Desktop, click Download .mcpb bundle.
   Straight there: app.affogata.com/n/account/settings/mcp-api-key
   See this screen

   

2. In Claude Desktop go to Settings › Extensions and drag the file onto Drag .MCPB or .DXT files here to install.
   Double-clicking the file works too, if your machine opens it with Claude.
   See this screen

   

3. Claude shows what the bundle is. Click Install, then switch Enabled on.
   If Affogata does not appear, or does not answer right away, close Claude Desktop and open it again. That usually settles it.
   See this screen

   

   See this screen

   

4. Worth doing once: Customize › Connectors › Affogata › Tool permissions, set Read-only tools to Always allow. Otherwise Claude asks your permission on every single question.
   See this screen

   

5. Check it worked. Ask Claude "list my Affogata filters" and you should get your own saved searches back.
   You drop the file in under Extensions, but once it is in, it is listed under Customize › Connectors with the type Desktop. That is where the tool permissions live.

The same account settings › MCP API key page shows a claude mcp add --transport http command with your key already in it. Copy it, run it in your terminal, done. It connects straight over HTTPS, with no bridge package to download and no Node.js of your own.

Only if your org blocks bundles as well. This is the old route and the only one that still needs Node.js installed. Check with node -v in a terminal, anything from v18 up is fine.

1. Claude Desktop › Settings › Developer, then click Edit config. That opens claude_desktop_config.json.
   If it opens a folder instead of the file, the file is at
   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add this inside the file, with your own key in place of YOUR_MCP_API_KEY:

{ "mcpServers": {
    "Affogata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.affogata.com/mcp",
               "--header", "Authorization: Bearer YOUR_MCP_API_KEY"]
    }
} }

The bundle will not install, or Extensions is missing

Bundles are a separate admin setting from connectors, so an org can lock both. Ask your Claude Owner to allow the Affogata bundle. It is a much smaller ask than opening a company connector.

Installed and enabled, but Claude does not use it

Open Customize › Connectors › Affogata and look at Tool permissions. If they are set to ask each time, set Read-only tools to Always allow.

I installed it and now I cannot find it

It is under Customize › Connectors, listed with the type Desktop. Extensions is only where you drop the file in.

npm error code SELF_SIGNED_CERT_IN_CHAIN

Hand-edit route only. Your corporate network inspects secure traffic and re-signs it, and npm does not trust that certificate even though your machine already does. Try NODE_OPTIONS=--use-system-ca in front of the command, or run the setup once on home wifi or a phone hotspot so the package is cached, then go back to the office network. This whole class of problem is why we recommend the bundle instead.

Error: Not ready after 60 seconds

Hand-edit route only. The first run has to download a bridge package and Claude gives up after 60 seconds. Run the same command once in a terminal to warm it up, then restart Claude.

npx not found, or nothing happens at all

Hand-edit route only. Node.js is not installed, or the terminal was not reopened after installing it. node -v will tell you.

Which key is this, exactly?

Your personal MCP API key from account settings › MCP API key. It is not the OAuth Client ID and Secret shown in the left column. Those two are for the company connector and are not interchangeable.