Docs MCP server

Connect AI coding assistants like Cursor, Claude Code, and Copilot to your product documentation using Biel.ai's Model Context Protocol (MCP) server. Your AI assistant can search and reference your docs while helping developers write code.

When your AI needs information about your product or API, it queries your documentation through MCP and receives relevant context to provide better answers without leaving your IDE.

Requirements

• A Biel.ai account with documentation indexed.
• Your project slug from the Biel.ai dashboard.
• An AI coding assistant that supports MCP (Cursor, Claude Code, VS Code / Copilot, or any MCP-compatible tool).
• API key (optional) — only for private projects on Business/Enterprise plans.

Setup

Biel.ai provides a hosted MCP server — no installation or maintenance required.

One-click configuration

1. Go to your Biel.ai Widget.
2. Click the Connect button.
3. Choose your preferred option:
   • MCP server URL: Copies the HTTP URL for manual configuration.
   • Claude Code: Copies the installation command to your clipboard.
   • Copilot (VS Code): Opens VS Code and adds the MCP server.
   • Cursor: Opens Cursor and adds the MCP server.

Manual configuration

Streamable HTTP (Recommended)

{
  "mcpServers": {
    "biel-ai": {
      "name": "Biel.ai",
      "type": "http",
      "url": "https://mcp.biel.ai/v2/YOUR_PROJECT_SLUG/mcp"
    }
  }
}

Streamable HTTP is the recommended connection method — it's the most reliable and fastest.

Legacy SSE (Deprecated)

{
  "mcpServers": {
    "biel-ai": {
      "description": "Query your product's documentation, APIs, and knowledge base.",
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.biel.ai/sse?project_slug=YOUR_PROJECT_SLUG"
      ]
    }
  }
}

Use this if your client doesn't support the Streamable HTTP protocol.

For IDE-specific setup instructions, refer to the official documentation:

• Cursor MCP setup
• VS Code / Copilot MCP setup
• Claude Code MCP setup

Usage

Automatic tool routing

Once configured, your IDE will automatically call the MCP server when it determines the query is relevant to your documentation. No additional setup is needed.

You can also add biel_ai anywhere in your message to explicitly trigger a search:

You: "biel_ai, how do I authenticate users?"
AI: [Searches your Biel.ai docs and provides answer with citations]

Custom instructions

For more control, you can add project-level instructions that tell your AI assistant to always check your documentation before responding.

Create a rule file with the following content and save it in your project:

For questions about our product documentation, API, or troubleshooting:
Use the biel-ai MCP server before responding.

Where to add instructions in each tool:

Tool	File location	Documentation
Cursor	.cursor/rules/*.mdc	Cursor rules
Claude Code	.claude/CLAUDE.md	Claude Code instructions
Copilot (VS Code)	.github/copilot-instructions.md	Copilot instructions

Configuration parameters

The Streamable HTTP URL includes the project_slug as a path parameter:

https://mcp.biel.ai/v2/{project_slug}/mcp

You can append these query parameters to customize the connection:

Parameter	Required	Description
api_key	No	API key for private projects (Business/Enterprise plans). Not needed if you've already set the api-key attribute on your <biel-button> or <biel-search-button>.
domain	No	Domain URL to pass as context. Required only if "Allowed domains" is enabled in project settings.
metadata	No	Tag to identify the conversation source (e.g., cursor).
base_url	No	Override the default API base URL. Defaults to https://app.biel.ai.
chat_uuid	No	UUID to continue a previous conversation.

Example:

https://mcp.biel.ai/v2/my-project/mcp?api_key=sk_...&domain=docs.example.com

Widget customization

These properties control how the MCP integration appears in your <biel-button> or <biel-search-button> widget.

Hide connect button

Set hide-connect-button="true" to hide the Connect button from the widget header. Use this when MCP is enabled for your project but you don't want to expose connection options to users.

<biel-button
  project="YOUR_PROJECT_ID"
  hide-connect-button="true"
>
  Ask AI
</biel-button>

The button is hidden regardless of whether MCP is enabled in your project settings.

Custom MCP server URL

Set mcp-server-url to override the default MCP URL. Use this for private projects that require an API key, self-hosted MCP servers, or testing with a staging server.

<biel-button
  project="YOUR_PROJECT_ID"
  mcp-server-url="https://mcp.biel.ai/v2/YOUR_PROJECT/mcp?api_key=sk_..."
>
  Ask AI
</biel-button>

When specified, this URL takes priority over the MCP URL provided by the API response.

See Widget Customization for all available widget properties.

Self-hosted option

For teams who prefer to host their own MCP server, see the self-hosting documentation on GitHub.

Troubleshooting

Connection issues

If your AI tool can't connect to the MCP server:

1. Verify project slug: Make sure it matches your Biel.ai project.
2. Network connectivity: Ensure your firewall allows connections to mcp.biel.ai.
3. Check project privacy: For private projects, ensure you have an API key.

No responses

If the AI tool isn't querying Biel.ai:

1. Include trigger keywords: Make sure to use biel_ai in your messages.
2. Check project status: Verify your Biel.ai project has indexed content.
3. Review logs: Check your AI tool's logs for MCP-related errors.

API key issues

API keys are only required for private projects and are available on Business and Enterprise plans.

If you are getting authentication errors:

1. Check if your project is private: Public projects don't need API keys.
2. Upgrade your plan: API keys require Business or Enterprise plan.
3. Regenerate API key: Create a new API key in your team settings if needed.