Connect with Claude Desktop

Connect the Claude desktop application to the Aembit MCP Server to query audit logs, authorization events, and workload events directly from Claude.

Note

Claude Desktop requires local configuration. The Claude web interface doesn’t support MCP connections.

Prerequisites

• Claude Desktop app installed (download)
• Aembit API Token and MCP Service URL (see Connect to the MCP Server)

Add Aembit’s MCP server to claude_desktop_config.json

Before you can use Claude Desktop with the Aembit MCP Server, you need to add your MCP server configuration to the claude_desktop_config.json file. This file tells Claude Desktop how to connect to the MCP Server and authenticate using your API Token.

Protect your API Token

Avoid committing API tokens to version control. Store tokens in environment variables or a secrets manager, and reference them in your configuration file.

1. Locate the claude_desktop_config.json file on your system:

   Operating System	Path
   macOS	~/Library/Application Support/Claude/claude_desktop_config.json
   Windows	%APPDATA%\Claude\claude_desktop_config.json

   Create the file if it doesn’t exist.

2. Add the Aembit MCP server configuration to claude_desktop_config.json, replacing the following values:

   • <tenantId> with your tenant ID from the Aembit Admin UI
   • <apiToken> with your Anthropic API Token

   claude_desktop_config.json

   {
     "mcpServers": {
       "aembit": {
         "command": "npx",
         "args": [
           "@anthropic-ai/mcp-proxy",
           "--remote-url",
           "https://<tenantId>.mcp.useast2.aembit.io/mcp"
         ],
         "env": {
           "ACCESS_TOKEN": "<apiToken>"
         }
       }
     }
   }

3. Restart Claude Desktop to load the new configuration.

Verify the connection

Verify that Claude Desktop connects successfully to the Aembit MCP Server and can query data.

1. Open Claude Desktop.
2. Go to Settings > Connectors (or check the MCP server indicator).
3. Confirm the Aembit server appears and shows as connected.
4. Try a prompt like: “List the available Aembit MCP tools.”

Example prompts

Once connected, you can ask Claude questions like:

• “Show me the last 10 audit log entries.”
• “What authorization events occurred in the past hour?”
• “List workload events for the api-gateway service.”

Claude translates your questions into structured MCP queries automatically. See the Prompt Library for example prompts and best practices.

Next steps

• If you have connection issues, see Troubleshooting.