---
title: "Brainfish MCP — Use Brainfish Inside Claude"
description: "Brainfish MCP — Use Brainfish Inside Claude"
canonical_url: "https://help.brainfi.sh/articles/brainfish-mcp-use-brainfish-inside-claude-sykvRMcDrV"
md_url: "https://help.brainfi.sh/articles/brainfish-mcp-use-brainfish-inside-claude-sykvRMcDrV.md"
---
# Brainfish MCP — Use Brainfish Inside Claude

**Ask Claude what's missing from your help center. Fix it in the same chat.**

Brainfish MCP connects Claude directly to your knowledge base. Search it, read from it, draft into it, audit it — all from inside the AI assistant your team already uses. No copy-pasting. No context-switching. No starting from scratch every time you open a new tab.

## What You Can Do

* **Find gaps** — ask Claude what's missing from your help center before customers find out
* **Draft articles** — turn a meeting note, Slack thread, or product brief into a published article without leaving Claude
* **Audit your KB** — inventory your workspace, spot duplicates, and batch-flag stale content in a single conversation
* **Run coverage tests** — fire test questions at your knowledge base and identify weak spots before customers do
* **Update articles** — fix outdated content and push changes back to Brainfish from inside Claude

## Requirements

* A Brainfish account with admin access
* A Brainfish API token (Settings → API Tokens) — or authenticate via OAuth directly in Claude.ai (under 60 seconds)
* One of: Claude Desktop, Claude.ai, Cursor, or VS Code with MCP extension

## Setup

### Option 1: Claude.ai (OAuth — fastest)


1. In Claude.ai, go to **Settings → Integrations**
2. Search for **Brainfish** and click Connect
3. Authenticate with your Brainfish account — done in under 60 seconds

### Option 2: Claude Desktop / Cursor / VS Code (JSON config)

**Step 1:** Get your Brainfish API token from **Settings → API Tokens**

**Step 2:** Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "brainfish": {
      "command": "npx",
      "args": ["-y", "@brainfish-ai/mcp"],
      "env": {
        "BRAINFISH_API_TOKEN": "your-api-token-here"
      }
    }
  }
}
```

**Step 3:** Restart Claude Desktop and start a conversation.

## Example Conversations

**Gap analysis:**
"Search my Brainfish knowledge base. Based on our new MCP release, what help articles are missing or need updating?"

**Article drafting:**
"Here are notes from our product meeting. Draft a customer-facing help article and create it in Brainfish."

**Audit:**
"List all articles in Brainfish that haven't been updated in the last 6 months and flag any that might be stale."

**Coverage test:**
"Ask my Brainfish knowledge base these 10 questions and tell me which ones it can't answer confidently."

## How Teams Use It

**Buffer** uses Brainfish MCP to draft and update Help Center articles from inside Claude, so every product update ships with documentation on the same day.

**Hearth** built real-time CS conversation guides grounded live in their Brainfish knowledge base, so every support agent responds like the most experienced one.

## Frequently Asked Questions

**Do I need to be a developer to use this?**
No. Claude.ai OAuth setup takes under 60 seconds with no config files. The JSON config option requires editing a text file, but day-to-day use is entirely conversational.

**What can the MCP read and write?**
It can search, retrieve, create, and update documents in your Brainfish knowledge base. An Agent Key is required for answer generation and follow-up tools.

**Is my knowledge base data sent to Claude?**
Only content you explicitly request in your conversation is retrieved and sent to Claude. Brainfish does not proactively push your data anywhere.

**How is this different from just copying articles into Claude?**
Context resets every time you close a tab. With MCP, Claude has persistent, searchable access to your entire knowledge base — not just what you paste in.