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/mcp

Use 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 connector

An official connector in Claude's directory — no URL to paste

If you are one person
1

Open the directory

The button above opens the Agility CMS listing. Inside Claude it's under Customize → Connectors → Discover: search for Agility CMS.

2

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.

If you administer a Team or Enterprise workspace
1

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.

2

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.

Or add it manually

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:

Name: Agility CMS
MCP Server URL: https://mcp.agilitycms.com/api/mcp

Or open the add-connector dialog with both filled in and confirm. Find it in Claude above also copies the URL to your clipboard.

Add the Agility CMS plugin (optional)

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

If you are one person
1

Open the listing

The button above opens Agility CMS in ChatGPT's plugin directory. You can also find it by searching the directory for Agility CMS.
2

Add it and sign in

Add the plugin, then sign in to Agility when prompted. ChatGPT sees exactly the instances and content your own Agility account can reach.
3

Use it in a chat

Ask about your Agility content in any conversation, or pick Agility CMS from the tools menu.

On a Business, Enterprise or Edu workspace, your admin may need to enable it first: see For your organization.

Or add it manually (Developer mode)

If the plugin isn't available to you, turn on Settings → Apps → Advanced settings → Developer mode, then choose Create and add:

Name: Agility CMS
MCP Server URL: https://mcp.agilitycms.com/api/mcp
Authentication: OAuth
M

Microsoft 365 Copilot

Coming soon

Agility 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

1

Install MCP Server

Run this command in your terminal:

claude mcp add --transport http "Agility-CMS" https://mcp.agilitycms.com/api/mcp
2

Authenticate with Agility CMS

Follow the OAuth flow to connect your Agility CMS account

3

Start Using MCP Tools

Access Agility CMS tools directly from Claude Code

Or install the plugin, with skills
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.

1

Install GitHub Copilot extension

Make sure you have the latest GitHub Copilot extension installed in VS Code

2

Open Command Palette

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)

3

Configure MCP Server

Run MCP: Add Server, choose HTTP, and add:

Server URL: https://mcp.agilitycms.com/api/mcp
Auth Type: OAuth
4

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.

1

Open Settings

Go to Cursor Settings → MCP

2

Add MCP Server

Click Add new MCP server, choose HTTP, and configure:

Name: Agility CMS
URL: https://mcp.agilitycms.com/api/mcp
Auth: OAuth
3

Connect Account

Complete OAuth authentication to link your Agility CMS instance

Windsurf

AI-first development environment

1

Access MCP Settings

Open Windsurf Settings → AI Tools → Model Context Protocol

2

Register Server

Add new MCP server with these details:

Server Name: Agility CMS MCP
Endpoint: https://mcp.agilitycms.com/api/mcp
Authentication: OAuth 2.0
3

Authorize Access

Follow the OAuth workflow to grant Windsurf access to your Agility CMS

C

OpenAI Codex

OpenAI's coding agent (CLI)

1

Add the server and sign in

Run these in your terminal. The second opens the Agility 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

1

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

2

Access Configuration File

Click “Manage MCP Servers” at the top → Click “View raw config”

3

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:

Server Name: Agility CMS MCP
Endpoint: https://mcp.agilitycms.com/api/mcp
Transport: streamable HTTP
Authentication: OAuth 2.0
4

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

1

Add the MCP Server

Run this command in your terminal:

gemini mcp add --transport http agility-cms https://mcp.agilitycms.com/api/mcp

Or add it manually to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "agility-cms": {
      "httpUrl": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}
2

Authenticate with Agility CMS

Run /mcp auth agility-cms and follow the sign-in to grant Gemini CLI access

3

Start Using MCP Tools

Run /mcp in Gemini CLI to confirm the Agility CMS tools are available

G

Goose

Open-source AI agent, desktop and CLI

1

Add the extension

Click the button to add Agility CMS as a remote (streamable HTTP) extension in Goose Desktop, or add it by hand with the endpoint above.
2

Sign in to Agility

Goose opens the Agility sign-in the first time it connects.

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.

Claude Team and Enterprise (claude.ai, Desktop, Cowork)
1

Add the connector for the organization

An Owner opens Organization settings → Connectors and adds Agility CMS from the directory. It is then available to every member, and each one connects their own Agility account.
2

Install the plugin for everyone (optional)

In Organization settings → Plugins & skills, choose Add → Sync from GitHub and enter 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.
Claude Code

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 }
}
ChatGPT Business, Enterprise and Edu

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.

Microsoft 365 Copilot (coming soon)

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.

VS Code and GitHub 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.

Cursor

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:

Content Management
  • • Get content models
  • • List containers
  • • Save content models
  • • Save containers
Component Management
  • • 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.