Skip to main content

Setting Up MCP in Claude Desktop

This guide walks you through configuring Claude Desktop to use the Agent Interviews MCP server, allowing you to access your interview data directly in your AI assistant.

Prerequisites​

  • An Agent Interviews account with API access
  • Your Agent Interviews API key
  • Claude Desktop installed on your computer
  • Node.js installed (required for running MCP servers)

Step 1: Download Claude Desktop​

If you haven't already, download Claude Desktop for your operating system:

Follow the installation instructions and make sure you're running the latest version by clicking on the Claude menu and selecting "Check for Updates..."

Step 2: Get Your API Key​

  1. Log in to your Agent Interviews account
  2. Navigate to Settings → API Keys
  3. Generate a new API key if you don't already have one
  4. Copy the API key - you'll need it for the configuration

Step 3: Configure Claude Desktop​

To set up the MCP server, you'll need to edit the Claude Desktop configuration file:

  1. Open Claude Desktop
  2. Click on the Claude menu on your computer and select "Settings..."
  3. Click on "Developer" in the left-hand bar of the Settings pane
  4. Click on "Edit Config"

This will open the configuration file located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Replace the file contents with the following:

{
  "mcpServers": {
    "agentinterviews": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.agentinterviews.com/mcp",
        "--header",
        "Authorization:${API_KEY}"
      ],
      "env": {
        "API_KEY": "Api-Key YOUR_API_KEY_HERE"
      }
    }
  }
}

Make sure to replace YOUR_API_KEY_HERE with your actual API key.

Step 4: Restart Claude Desktop​

After updating your configuration, you need to restart Claude Desktop completely.

Upon restarting, you should see a slider icon in the bottom left corner of the input box. Clicking on this icon will show you the available tools, including the Agent Interviews tools.

Step 5: Verify the Connection​

  1. Start a new conversation with Claude
  2. Type "Check MCPs in function tools"
  3. Ask "What Agent Interviews tools are available?"
  4. Claude should respond with information about the available tools

Using MCP in Claude Desktop​

Once configured, you can interact with your Agent Interviews data by asking Claude questions about your interviews, projects, and more. For example:

  • "Show me my recent interviews"
  • "Get the transcript from my interview with candidate X"
  • "What's the status of project Y?"

Claude will use the appropriate Agent Interviews MCP tools to retrieve the information you need.

Managing MCP Access​

You can enable or disable the Agent Interviews MCP at any time:

  1. Go to Settings → MCPs
  2. Toggle the switch next to "Agent Interviews" to enable or disable it

This allows you to control when Claude has access to your interview data.

Troubleshooting​

If your MCP server isn't showing up in Claude Desktop:

  1. Restart Claude Desktop completely
  2. Check your configuration file syntax for errors
  3. Verify that Node.js is installed by running node --version in your terminal
  4. Try manually running the MCP server to see if there are any errors

Getting Logs from Claude Desktop​

Claude Desktop logging related to MCP is written to log files in:

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

Look for:

  • mcp.log for general logging about MCP connections
  • mcp-server-agentinterviews.log for error logging specific to the Agent Interviews server

You can view recent logs by running:

macOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Windows:

type "%APPDATA%\Claude\logs\mcp*.log"

If problems persist, contact Agent Interviews support for assistance.