diff --git a/api-usage/mcp-server.mdx b/api-usage/mcp-server.mdx index 65616ac..0eaab25 100644 --- a/api-usage/mcp-server.mdx +++ b/api-usage/mcp-server.mdx @@ -6,6 +6,51 @@ icon: "); mask-image: url('/images/icons/mcp.svg'); mask-size: 100% 100%;/*" Membit MCP Server connects your AI systems to live social insights via Membit's API. Using the Model Context Protocol (MCP), the server exposes tools that make up-to-the-minute social context—trending discussion clusters, raw posts, and more—available to your AI agents in Cursor, Claude Desktop, Goose, and any MCP-compatible client. +## Available tools + +These tools are exposed by the Membit MCP server and can be called by MCP-compatible clients (e.g., Cursor, Claude Desktop). + +### clusters.search + +Search for trending discussion clusters across platforms. + + + Free-text query describing the topic (e.g., "ai agents", "us elections"). + + + + Maximum number of clusters to return. Range: 1–50. + + +### clusters.info + +Get detailed context for a specific cluster label, including representative posts. + + + Cluster label obtained from `clusters.search`. + + + + Maximum number of representative posts to include. Range: 1–50. + + +### posts.search + +Search raw social posts that match your query across supported platforms. + + + Free-text query describing the topic or keywords. + + + + Maximum number of posts to return. Range: 1–100. + + + + All tools respect privacy: results surface public conversations only and never + expose personal identifiers beyond public metadata. + + ## Remote MCP Server Connect Membit's remote MCP server directly without the need for local setup. This approach offers a streamlined experience that eliminates local installation and configuration requirements. diff --git a/docs.json b/docs.json index 84d9f26..2ce348b 100644 --- a/docs.json +++ b/docs.json @@ -52,7 +52,8 @@ "integrations/no-code-agent-frameworks/gumloop", "integrations/no-code-agent-frameworks/flowise", "integrations/no-code-agent-frameworks/langflow", - "integrations/no-code-agent-frameworks/cursor" + "integrations/no-code-agent-frameworks/cursor", + "integrations/no-code-agent-frameworks/claude" ] }, { @@ -102,4 +103,4 @@ "github": "https://github.com/bandprotocol" } } -} \ No newline at end of file +} diff --git a/images/claude/membit-mcp.png b/images/claude/membit-mcp.png new file mode 100644 index 0000000..8646735 Binary files /dev/null and b/images/claude/membit-mcp.png differ diff --git a/images/claude/talk-with-chat.png b/images/claude/talk-with-chat.png new file mode 100644 index 0000000..6396d8c Binary files /dev/null and b/images/claude/talk-with-chat.png differ diff --git a/images/icons/claude.png b/images/icons/claude.png new file mode 100644 index 0000000..968d3e2 Binary files /dev/null and b/images/icons/claude.png differ diff --git a/integrations/no-code-agent-frameworks/claude.mdx b/integrations/no-code-agent-frameworks/claude.mdx new file mode 100644 index 0000000..b7cc649 --- /dev/null +++ b/integrations/no-code-agent-frameworks/claude.mdx @@ -0,0 +1,192 @@ +--- +title: "Claude Desktop" +description: "Integrate real-time context to your Claude Desktop via Membit MCP." +icon: "); mask-image: url('/images/icons/claude.png'); mask-size: 100% 100%;/*" +--- + +Claude Desktop supports custom MCP integrations (currently in beta). By connecting Membit, you give Claude access to real-time social context—so it can answer with what's happening now across the web. + +## Prerequisites + +Before you begin, make sure you have: + +- Claude Desktop installed (macOS or Windows) +- A Membit account with an API key [get your API key](/access-and-auth) +- Basic familiarity with editing configuration files + +## Set up Membit Remote MCP + +Follow these steps to enable the Membit MCP server in Claude Desktop: + + + +Use the correct path for your OS. + + + + +```bash +nano ~/Library/Application\ Support/Claude/claude_desktop_config.json +``` + + + + +```powershell +notepad C:\Users\%USERNAME%\AppData\Roaming\Claude\claude_desktop_config.json +``` + + + + + +If the file doesn't exist, these commands will create it when you save. + + + + +Paste the following JSON into `claude_desktop_config.json`: + +```json +{ + "mcpServers": { + "membit-remote-mcp": { + "command": "npx", + "args": [ + "-y", + "mcp-remote", + "https://mcp.membit.ai/mcp", + "--header", + "X-Membit-Api-Key:${API_KEY}" + ], + "env": { + "API_KEY": "" + } + } + } +} +``` + + +Replace `` with your actual Membit API key. Keep this credential secure and never share it publicly. + + + +Validate your JSON: ensure quotes are correct and there are no trailing commas. + + + + + Completely quit and reopen Claude Desktop to load the new MCP configuration. + + + +Open Claude and confirm the Membit MCP tools are available. + + + Claude Desktop showing Membit MCP tools available + + + +You should see Membit tools available for use when Claude performs tool calls. + + + + +## Use Membit with Claude + +Now that the integration is set, try a chat enhanced with real-time context: + + + +Open Claude Desktop and begin a conversation. + + + +Try prompts that benefit from up-to-the-minute context: + +- "What's trending in AI today?" +- "Summarize the latest crypto news from real conversations" +- "What are people discussing about [your topic] right now?" + + + Claude may ask to run tools—allow tool usage so it can call the Membit MCP. + + + + Claude chat showing responses with real-time context + + + +Responses should include timely insights sourced from current public conversations. + + + + +## Troubleshooting + + + +**Problem**: Claude doesn't load the MCP configuration. + +**Solutions**: + +- Verify the file path is exact for your OS: + - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` + - Windows: `C:\\Users\\%USERNAME%\\AppData\\Roaming\\Claude\\claude_desktop_config.json` +- Ensure Claude Desktop was fully restarted after edits +- Confirm the file encoding is UTF-8 without BOM + + + + +**Problem**: Configuration fails to parse. + +**Solutions**: + +- Validate JSON with an online linter +- Remove trailing commas and ensure double quotes are used +- Confirm braces and brackets are properly matched + + + + +**Problem**: Membit tools show auth errors. + +**Solutions**: + +- Ensure `env.API_KEY` contains your exact Membit API key +- Confirm the header name is `X-Membit-Api-Key` (case-sensitive) +- Regenerate your API key in Membit if issues persist + + + + +**Problem**: Tools don't show up in Claude. + +**Solutions**: + +- Double-check the `mcpServers` object name and structure +- Ensure `npx` is available on your system PATH +- Try adding `-y` to `npx` args (already included above) +- Restart Claude after any config changes + + + + +**Problem**: Claude replies without using the MCP. + +**Solutions**: + +- Make prompts more explicit: "Use the available tools to check what's happening now about..." +- Allow tool usage when prompted in the chat +- Ask about timely topics that require fresh context + + +