Skip to main content

​
Overview

The Onyx MCP Server lets you connect any MCP-compatible AI tool to your Onyx knowledge base. Ask Claude, Cursor, Windsurf, or any other MCP client to search your company’s documents without leaving your workflow.

​
What You Can Do

  • Search your knowledge base — query Confluence, Google Drive, Slack, GitHub, Jira, and 40+ other sources
  • Search the web — find current events and public information
  • Fetch full page content — retrieve complete text from any URL
All of your existing Onyx permissions and access controls are enforced automatically.

​
Supported Clients

Any client that supports the Model Context Protocol over HTTP works with Onyx, including:

​
Quick Setup

Add this to your MCP client’s configuration: 
{
  "mcpServers": {
    "onyx": {
      "url": "https://cloud.onyx.app/mcp", // or your self-hosted Onyx domain
      "headers": {
        "Authorization": "Bearer YOUR_ONYX_TOKEN_HERE"
      }
    }
  }
}
Replace YOUR_ONYX_TOKEN_HERE with a Personal Access Token or API Key.

​
Learn More

Full MCP Server Guide

Detailed setup instructions, tool reference, troubleshooting, and self-hosting configuration

Personal Access Tokens

Create a token to authenticate with the MCP server