Setup Instructions
Connect the Agility CMS MCP Server to your favorite AI tools
Add to Claude and Add to ChatGPT open Agility CMS in each assistant's own directory, so there is no URL to paste. The buttons install it in one click in VS Code, Cursor, LM Studio or Goose. Rolling it out to a whole team? See For your organization.
MCP Server URL
https://mcp.agilitycms.com/api/mcpUse this URL when configuring the MCP server in your tools
One-Click Install Available
Claude and ChatGPT add Agility CMS from their directories, and VS Code, Cursor, LM Studio and Goose take a one-click link. Every option signs you in with your own Agility account. Admins can make it available to everyone at once: see For your organization.
Claude (Desktop & Web)
Official connectorAn official connector in Claude's directory — no URL to paste
Open the directory
The button above opens the Agility CMS listing. Inside Claude it's under Customize → Connectors → Discover: search for Agility CMS.
Connect
Pick Agility CMS — not Agility CMS Knowledgebase, which is our separate docs connector — and sign in to Agility when prompted. Claude then sees exactly the instances and content your own Agility account can reach, nothing more.
Enable it for the organization
From your workspace admin settings, enable the Agility CMS connector. That makes it available to everyone; it does not connect anyone.
Each person still connects their own account
Every member signs in to Agility individually, and their own Agility permissions govern every call. Enabling the connector grants no content access by itself, and there is no shared or service credential.
If the directory entry has not reached you yet, the endpoint still works on its own. Customize → Connectors → Add, then add it as a custom connector:
Or open the add-connector dialog with both filled in and confirm. Find it in Claude above also copies the URL to your clipboard.
The plugin bundles the connector with nine skills that teach Claude how to work in Agility: getting started, editing content, writing an article, brand voice, publishing and workflow, building pages, content modeling, a go-live check and building a front end. It also connects the Agility documentation server. It is published from github.com/agility/mcp-server, and its listing in Claude's plugin directory is on its way.
In Claude Code:
claude plugin marketplace add agility/mcp-server claude plugin install agility-cms@agility
For claude.ai and Cowork, an organization Owner adds it once for everyone: see For your organization.
ChatGPT
Agility CMS is in ChatGPT's plugin directory
Open the listing
Add it and sign in
Use it in a chat
On a Business, Enterprise or Edu workspace, your admin may need to enable it first: see For your organization.
If the plugin isn't available to you, turn on Settings → Apps → Advanced settings → Developer mode, then choose Create and add:
Microsoft 365 Copilot
Coming soonAgility CMS for Microsoft 365 Copilot is in Microsoft's review
Once it is approved, your Microsoft 365 admin makes it available in the admin center (see For your organization), and each person signs in to Agility from Copilot.
Claude Code
The official CLI for Claude
Install MCP Server
Run this command in your terminal:
claude mcp add --transport http "Agility-CMS" https://mcp.agilitycms.com/api/mcpAuthenticate with Agility CMS
Follow the OAuth flow to connect your Agility CMS account
Start Using MCP Tools
Access Agility CMS tools directly from Claude Code
claude plugin marketplace add agility/mcp-server claude plugin install agility-cms@agility
GitHub Copilot for VS Code
Setup with OAuth authentication
Quick Install: Click the button above for automatic setup, or follow the manual steps below. Agility CMS is also in the GitHub MCP Registry, and in VS Code you can search for it in the Extensions view with @mcp.
Install GitHub Copilot extension
Make sure you have the latest GitHub Copilot extension installed in VS Code
Open Command Palette
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
Configure MCP Server
Run MCP: Add Server, choose HTTP, and add:
Authenticate
Follow the OAuth flow to connect your Agility CMS account
Cursor
AI-powered code editor
Quick Install: Click the button above for automatic setup, or follow the manual steps below.
Open Settings
Go to Cursor Settings → MCP
Add MCP Server
Click Add new MCP server, choose HTTP, and configure:
Connect Account
Complete OAuth authentication to link your Agility CMS instance
Windsurf
AI-first development environment
Access MCP Settings
Open Windsurf Settings → AI Tools → Model Context Protocol
Register Server
Add new MCP server with these details:
Authorize Access
Follow the OAuth workflow to grant Windsurf access to your Agility CMS
OpenAI Codex
OpenAI's coding agent (CLI)
Add the server and sign in
codex mcp add agility-cms --url https://mcp.agilitycms.com/api/mcp codex mcp login agility-cms
Google Antigravity
Agentic development platform from Google
Open MCP Server Configuration
In Antigravity, click on Agent session → select the “...” dropdown at the top of the editor's side panel → Select MCP Servers
Access Configuration File
Click “Manage MCP Servers” at the top → Click “View raw config”
Add Agility CMS MCP Server
Add it as a remote (HTTP) MCP server with these details — this server is hosted, so there is nothing to install locally:
Refresh and Connect
Return to “Manage MCP Servers” and click Refresh. The Agility CMS tools will now be available in your agent sessions.
Gemini CLI
Google's command-line AI agent
Add the MCP Server
Run this command in your terminal:
gemini mcp add --transport http agility-cms https://mcp.agilitycms.com/api/mcpOr add it manually to your ~/.gemini/settings.json:
{
"mcpServers": {
"agility-cms": {
"httpUrl": "https://mcp.agilitycms.com/api/mcp"
}
}
}Authenticate with Agility CMS
Run /mcp auth agility-cms and follow the sign-in to grant Gemini CLI access
Start Using MCP Tools
Run /mcp in Gemini CLI to confirm the Agility CMS tools are available
Goose
Open-source AI agent, desktop and CLI
Add the extension
Sign in to Agility
For your organization
An admin can make Agility CMS available to everyone, or install it for them, in each of these tools. It never grants content access by itself: every person still signs in to Agility once, and their own Agility permissions decide what the assistant can see and change. There is no shared or service credential.
Add the connector for the organization
Install the plugin for everyone (optional)
agility/mcp-server. Then set the plugin's default access to Available to install, Installed by default or Required. Enterprise plans can set this per group. The plugin's connector still has to be added in step 1.Push the plugin to every developer with managed settings, either from Organization settings → Claude Code → Managed settings or with your device-management tool as managed-settings.json. For one project, the same keys in a checked-in .claude/settings.json apply once each person trusts the folder.
{
"extraKnownMarketplaces": {
"agility": { "source": { "source": "github", "repo": "agility/mcp-server" } }
},
"enabledPlugins": { "agility-cms@agility": true }
}A workspace admin opens Workspace settings → Plugins, finds Agility CMS, and sets its installation policy to Available (people add it themselves) or Installed (it is added for them), for the whole workspace or, on Enterprise and Edu, for chosen roles. Make sure the Agility CMS app is enabled under Workspace settings → Apps too. Each person signs in to Agility the first time they use it.
Once Microsoft approves Agility CMS for Microsoft 365 Copilot, a Microsoft 365 admin turns it on under Copilot → Connectors in the Microsoft 365 admin center and sets its rollout to everyone or to chosen users and groups. Each person then signs in to Agility from Copilot.
Check this into a repository as .vscode/mcp.json and everyone who opens it in VS Code gets the server, after confirming it once:
{
"servers": {
"agility-cms": { "type": "http", "url": "https://mcp.agilitycms.com/api/mcp" }
}
}GitHub Enterprise admins who restrict MCP servers can allow it by URL (https://mcp.agilitycms.com/*) in their Copilot MCP policy, or through the GitHub MCP Registry, where Agility CMS is listed.
Check this into a repository as .cursor/mcp.json to share it with the team. Enterprise admins who use Cursor's MCP allowlist can allow https://mcp.agilitycms.com/*.
{
"mcpServers": {
"agility-cms": { "url": "https://mcp.agilitycms.com/api/mcp" }
}
}📋 Prerequisites
- •Active Agility CMS account with API access
- •Valid Agility CMS instance with content models
- •An MCP-compatible tool: Claude, ChatGPT, Microsoft 365 Copilot (coming soon), GitHub Copilot in VS Code, Cursor, Windsurf, Claude Code, Codex, Gemini CLI, Goose, LM Studio or Google Antigravity
- •Internet connection for OAuth authentication
🛠️ Available MCP Tools
Once connected, you'll have access to these Agility CMS tools:
- • Get content models
- • List containers
- • Save content models
- • Save containers
- • Get component models
- • Save component models
- • Available instances
- • Field type management
Need Help?
If you encounter any issues during setup, our support team is here to help.
