OpalServeThe Control Plane for Your Team's AI Tools

Share MCP servers, knowledge bases, and usage analytics across your engineering team. Works with Claude Code, Cursor, Codex, and any MCP-compatible tool.

📡

Team MCP Registry

Register MCP servers once on a central hub. Every developer on your team gets access instantly — no per-machine setup, no config drift.

📚

Shared Knowledge Base

Upload engineering docs, runbooks, and architecture decisions. AI tools query them via MCP so every code assistant has your team's context.

📊

Admin Dashboard

React SPA with real-time usage charts, server health monitoring, user management, and API key administration. See exactly how your team uses AI tools.

🔒

Auth & Access Control

User accounts, API key management, per-user rate limits, and granular permissions. Control who can access what across your entire AI tool stack.

🔗

GitHub + Slack

Ingest repository context automatically via webhooks. Slash commands for Slack. Push notifications for server health. Connect your existing workflows.

🌐

MCP Gateway

One endpoint, all your tools. Any MCP-compatible client connects to OpalServe and gets access to every registered server. Zero client-side config.

How It Works

OpalServe sits between your AI coding tools and your MCP servers. Instead of every developer configuring servers locally, the team admin sets them up once and everyone syncs.

Step 1 — Install

bash

npm install -g opalserve

Step 2 — Configure

bash

opalserve init          # Interactive setup wizard
opalserve admin init    # Initialize team server (admin only)

Step 3 — Share

bash

# Team members connect in one command
opalserve login https://opalserve.yourcompany.com
opalserve sync

Every developer on your team now has access to the same MCP servers, the same knowledge base, and the same tool configurations. No more "works on my machine."

Architecture

  [GitHub]  [Slack]  [Filesystem]  [PostgreSQL]
      \        |         |           /
       --------+---------+----------
               | MCP Protocol
     +---------+---------+---------+
     |     OpalServe Team Server   |
     |                             |
     |  MCP Registry + Gateway     |
     |  Shared Knowledge Base      |
     |  Auth / API Keys / RBAC     |
     |  Usage Analytics Dashboard  |
     |  Rate Limiting              |
     |  GitHub + Slack Webhooks    |
     |                             |
     |  SQLite ── Fastify (:3456)  |
     +---------+---------+---------+
               |
     HTTPS API + MCP (stdio/SSE)
               |
     +---------+---------+---------+
     |         |         |         |
   Dev A     Dev B     Dev C     CI/CD
  Claude    Cursor    Codex     Agent

OpalServe connects to your backend MCP servers (GitHub, Slack, databases, filesystems) and exposes all their tools through a unified gateway. Developers run opalserve sync to pull the team config, then their AI tools connect to OpalServe instead of managing individual server configs.

Quick Start

bash

# Install globally
npm install -g opalserve

# Run the setup wizard
opalserve init

# Start the registry
opalserve start

# Add an MCP server
opalserve server add --name github \
  --stdio "npx -y @modelcontextprotocol/server-github" \
  --env GITHUB_TOKEN=ghp_your_token

# Search across all tools
opalserve tools search "create issue"

Ready for more?

See the Getting Started guide for a complete walkthrough, or jump to Team Setup to configure OpalServe for your engineering team.

Team Mode

In team mode, OpalServe runs as a shared server that your entire engineering team connects to.

bash

# Admin: initialize the team server
opalserve admin init
opalserve start --mode team-server

# Admin: invite team members
opalserve admin invite alice@company.com
opalserve admin invite bob@company.com

# Developers: login and sync
opalserve login https://opalserve.internal.company.com
opalserve sync

# Now every team member has access to the same tools
opalserve tools search "deploy"

Team mode includes a React admin dashboard for monitoring usage, managing users, and configuring servers through a web interface.

100% Open Source

OpalServe is released under the MIT License. Self-host it on your own infrastructure, modify it to fit your workflow, and contribute back to the project.

No vendor lock-in. No usage-based pricing. No telemetry. Your data stays on your servers.

bash

# Clone and run locally
git clone https://github.com/adityaidev/opalserve.git
cd opalserve
pnpm install
pnpm dev