> This page is for version v8.3.0 (default).
> For other versions, use one of these documentation indexes:
> - v8.3.0 (default): https://docs.workflows.com/v-8-3-0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.workflows.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.workflows.com/_mcp/server.

# Installation Guide

> **Prerequisites**
>
> Before you begin, get your API key from your [Mind Reasoner dashboard](https://app.workflows.com). You'll need this to authenticate your connection.

## Quick Setup with Claude CLI

The fastest way to connect to the Mind Reasoner MCP Server:

#### Get Your API Key

Log in to your [Mind Reasoner account](https://app.workflows.com) and copy your API key from the dashboard. Keep it secure—treat it like a password.

#### Connect the Server

Run this command to connect Claude to Mind Reasoner:

```bash
claude mcp add --transport http mind-reasoner \
  https://mcp.mindsim.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

Replace `YOUR_API_KEY` with your actual API key from Step 1.

#### Start Using It

Restart Claude Desktop. The Mind Reasoner tools are now available. Try asking: "Create a new mind called Sales Manager."

> **You're Connected**
>
> You can now create minds, upload data, and run simulations directly from Claude. No installation, no servers to manage—just instant access to digital twin technology.

---

## Setup for Other MCP Clients

If you're using an MCP client other than Claude, add this configuration to your client's settings:

**`MCP Client Configuration`**

```json title="MCP Client Configuration"
{
  "mcpServers": {
    "mind-reasoner": {
      "url": "https://mcp.mindsim.com/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer {{API_KEY}}"
      }
    }
  }
}
```

Refer to your MCP client's documentation for the specific configuration file location.

---

## Verifying Your Connection

After connecting, verify everything is working:

### Check Server Registration

```bash
claude mcp list
```

You should see `mind-reasoner` in the list of connected servers.

### Test Your First Command

Ask: "What Mind Reasoner MCP tools do you have access to?"

Mind Reasoner should respond with a list of the eight available tools: get_all_minds, search_minds, create_mind, get_signed_upload_url, upload_file_to_signed_url, create_snapshot, get_snapshot_status, and simulate.

---

## Optional: Connect to Gong, Fathom, or Fireflies

Already using conversation intelligence platforms? Connect them to access your existing transcript repositories without manual file uploads.

> **Completely Optional**
>
> Integrations are entirely optional. The MCP server works perfectly with just your Mind Reasoner API key. Only configure integrations if you want to pull transcripts directly from these platforms.

### Choose Your Integration Approach

You can connect to these platforms in two ways:

**Option 1: Use Our MCP Server Integrations** (Recommended for simplicity)

* Add integration credentials to the MCP server configuration
* Access transcripts through the same AI conversation interface
* No additional code or setup required
* Works seamlessly with Mind Reasoner workflows

**Option 2: Integrate Directly in Your Own Workflows**

* Use Gong, Fathom, or Fireflies APIs independently
* Full control over data processing and workflows
* Combine with Mind Reasoner API as needed
* Better for custom integrations or specialized workflows

### Quick Links to Integration Setup

For detailed setup instructions and credential management:

* [Gong Integration Setup](/mcp-integrations-gong-setup) - Connect to sales call recordings
* [Fathom Integration Setup](/mcp-integrations-fathom-setup) - Connect to meeting transcripts
* [Fireflies Integration Setup](/mcp-integrations-fireflies-setup) - Connect to meeting recordings

Each guide covers:

* How to obtain API credentials from the platform
* Configuration for both hosted and self-hosted deployments
* Authentication testing and troubleshooting
* Links to official API documentation for direct integration

> **Seamless Experience**
>
> When configured, integration tools appear automatically alongside Mind Reasoner tools. Simply ask: "Show me my last 5 Gong calls" or "Create a mind from my most recent Fathom meeting."

---

## Troubleshooting

### Connection Issues

If Claude can't connect to the MCP server:

**Verify the server is registered:**

```bash
claude mcp list
```

**Test the connection manually:**

```bash
curl -X POST https://mcp.mindsim.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

### Authentication Errors

If you see "Unauthorized" or 401 errors:

* Double-check your API key in the Mind Reasoner dashboard
* Ensure the format is correct: `Bearer YOUR_API_KEY` (note the space)
* Verify there are no extra spaces or typos
* Try generating a new API key if the issue persists

### Tools Not Appearing

If Mind Reasoner tools aren't available:

* Restart Claude Desktop or Claude Code after adding the server
* Verify the server appears in `claude mcp list`
* Check your configuration file syntax (must be valid JSON)
* Try explicitly asking: "What MCP tools are available?"

---

## Security Best Practices

> **Protect Your API Key**
>
> Your API key provides access to your Mind Reasoner account. Treat it like a password:
>
> * Never share your API key in messages or screenshots
> * Don't commit API keys to version control
> * Use environment variables for configuration
> * Rotate your key periodically from the dashboard
> * If compromised, generate a new key immediately

---

## What's Next?

Now that you're connected, explore what you can do:

📚

### Learn the Tools

Explore the [Tools Reference](/mcp-tools) for detailed documentation of all eight MCP tools and their capabilities.

💡

### See Examples

Check out [Workflow Examples](/mcp-workflows) for complete use cases like sales training and customer service optimization.

🚀

### Try It Now

Try saying: "Create a mind for my customer service lead named Sarah, then guide me through uploading training data."