AI Integration (MCP) overview

Casewhere exposes its configuration surface as a Model Context Protocol (MCP) server, so AI coding assistants — Claude Code, GitHub Copilot, and OpenAI Codex — can help you build and maintain Casewhere solutions in natural language. Instead of clicking through Casewhere Admin, you can ask an assistant to create a data class, add a workflow activity, wire up a widget, or refactor a rule, and it carries out the change through the same Admin APIs you use.

AI Integration is available in Casewhere 2.9.9 and later. It is turned on by an administrator (see Connect an AI assistant). When enabled, an AI Integration panel appears on the Casewhere Admin home page.

How it works

The Casewhere MCP server is a shared service: a single deployment can connect to any number of Casewhere instances. It does not keep a copy of your configuration — it is a thin proxy that forwards every operation to a specific Casewhere instance's Admin API, acting as you.

Because the server is shared, every request your assistant makes carries two HTTP headers that tell the server which instance to target and who is acting:

Header Value Purpose
X-Casewhere-BaseUrl Base URL of your Casewhere instance (e.g. https://admin-local.casewhere.com/) Tells the MCP server which Casewhere instance to call. All requests are proxied to this URL, so it must be reachable from the server.
Authorization Bearer <AI Access Token> Authenticates the request. The assistant uses your AI Access Token, so it inherits your permissions and identity for every action it performs. 
flowchart LR
    DEV["You + AI assistant<br/>(Claude Code / Copilot / Codex)"] -->|"MCP over HTTP + your two headers"| MCP{{"Casewhere MCP server<br/>(shared service)"}}
    MCP -->|"proxies Admin API calls as you"| ADMIN["Casewhere Admin<br/>(your instance)"]
    ADMIN --> STORE[("Configuration<br/>Event Sourcing + MongoDB")]
    style MCP fill:#1f6feb,color:#ffffff,stroke:#11448a

The important consequences of this design:

  • The AI Access Token is a personal, time-limited credential you generate in Casewhere Admin. It represents you — every action the assistant performs is authorized and audited exactly as if you had done it by hand.
  • The token is valid for 30 days, and you can revoke all your tokens at any time.
  • The MCP server runs over HTTP; its endpoint is the configured MCP Base URL with /mcp appended (for example https://mcp-local.casewhere.com/mcp).
  • Nothing is stored on the MCP server. Point a different X-Casewhere-BaseUrl at it and the same server works against another environment.

What you can do

The MCP server exposes the Casewhere configuration model as a large catalog of tools that span the whole platform — products, data classes, data sources, processes, workflows and activities, widgets and pages, worker sites, themes, rules, triggers, schedulers, IdP connections, text resources, documents, DevOps packages, and workflow tests. In practice you can ask an assistant to:

See Working with MCP tools for the full tool catalog, naming conventions, and edit semantics.

Before you start

  • An administrator must enable AI Integration and set the MCP Base URL for your environment (see Connect an AI assistant).
  • You need a Casewhere Admin account — the assistant acts with your permissions, so it can only do what you can do.
  • You need a supported assistant: Claude Code, GitHub Copilot (VS Code 1.99+, Agent mode), or OpenAI Codex.

In this section

Topic Description
Connect an AI assistant Enable the feature, generate a token, download the AI Workspace, and connect your editor
Working with MCP tools Tool catalog, naming conventions, edit semantics, guides, and safety