CXone Knowledge Base MCP Server

Query the CXone KB (WFI, DBConnector, Studio) from Claude Code without any GitHub dependencies.

This is a lightweight MCP server that fetches KB content directly from GitHub and makes it queryable through Claude Code. No GitHub MCP required.

Installation

Option 1: Local Development (This Repo)

cd tools/cbba-kb-mcp
npm install
npm start

Then add to your ~/.claude.json:

{
  "mcpServers": {
    "cbba-kb": {
      "type": "stdio",
      "command": "node",
      "args": ["/full/path/to/cbba-kt/tools/cbba-kb-mcp/index.js"]
    }
  }
}

Option 2: From npm (Coming Soon)

npm install -g cbba-kb-mcp

Then add to ~/.claude.json:

{
  "mcpServers": {
    "cbba-kb": {
      "type": "stdio",
      "command": "cbba-kb-mcp"
    }
  }
}

Restart Claude Code:

claude --restart-servers

Usage

Once installed and running, the KB MCP provides these tools in Claude Code:

1. Search the KB

"Search the knowledge base for 'rule activation'"

Returns matching sections from handbooks with relevant quotes.

2. List Available Handbooks

"What handbooks are available in the knowledge base?"

Shows all available topics (WFI, DBConnector, Studio, etc.).

3. Get FAQ

"Show me the WFI FAQ"
"Show me the DBConnector FAQ"

Returns the complete FAQ section for that system.

4. Get Troubleshooting Guide

"Show me the WFI troubleshooting guide"
"Show me the DBConnector troubleshooting guide"
"Show me the Studio troubleshooting guide"

Returns logs, diagnostics, and triage information.

5. Get Logs Reference

"Show me where to look for WFI logs"
"Show me DBConnector log signatures"

Returns log locations, formats, and common signatures.

Example Queries

Support Team Escalation

User: "A customer reports: 'Error: RegisterDBXService returned empty GUID'"
Claude Code: [Uses search_kb to find the error]
Result: "Log signature found in DBConnector logs handbook with triage steps..."

Developer Onboarding

User: "How does WFI rule activation work?"
Claude Code: [Uses search_kb + FAQ]
Result: Returns architecture overview + FAQ answers

Troubleshooting

User: "Where should I look for WFI errors?"
Claude Code: [Uses get_logs_reference]
Result: Returns log locations, order, and decision tree

How It Works

1. Fetches from GitHub — Uses raw.githubusercontent.com to fetch KB files on demand
2. Caches content — Caches files for 5 minutes to avoid repeated API calls
3. Implements MCP tools — Makes KB data queryable through Claude Code
4. No external dependencies — Just the MCP SDK, nothing else

Requirements

• Node.js 18+
• @modelcontextprotocol/sdk (installed via npm)
• Internet connection (to fetch from GitHub)

Architecture

The server provides 5 MCP tools:

| Tool | Purpose | |------|---------| | search_kb | Full-text search across handbooks | | list_handbooks | Show all available topics | | get_faq | Fetch FAQ for WFI/DBConnector | | get_troubleshooting | Fetch troubleshooting guides | | get_logs_reference | Fetch logs and diagnostics info |

All tools fetch content from: https://raw.githubusercontent.com/inContact/cbba-kt/main/knowledge-base/

Troubleshooting

"Command not found: cbba-kb-mcp"

Make sure Node is installed and the npm package path is in your $PATH:

npm install -g cbba-kb-mcp
which cbba-kb-mcp

"Failed to fetch KB files"

Check your internet connection. The server fetches from GitHub API:

curl https://raw.githubusercontent.com/inContact/cbba-kt/main/knowledge-base/README.md

"Claude Code doesn't see the tools"

Restart the MCP servers:

claude --restart-servers

Development

To modify the server:

1. Edit index.js to add new tools or sources
2. Test locally: npm start
3. Verify in Claude Code
4. Commit changes

To publish to npm:

npm version minor
npm publish

Related

• CLAUDE_CODE_SETUP.md — Full Claude Code setup guide
• REMOTE_KB_QUICK_START.md — Quick reference for users
• knowledge-base/ — The actual KB content