Setup Instructions

Connect the Agility CMS MCP Server to your favorite AI tools

Add to Claude opens Claude's connector directory on the Agility CMS entry — it is an official connector now, so there is no URL to paste. Click a badge for one-click install in VS Code, Cursor or LM Studio, or scroll down for every supported tool.

MCP Server URL

https://mcp.agilitycms.com/api/mcp

Use this URL when configuring the MCP server in your tools

One-Click Install Available

Click the install badges below to automatically configure the Agility CMS MCP server in your preferred tool. The configuration will be set up for you instantly!

Claude (Desktop & Web)

Official connector

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

If you are one person

Open the directory

Customize → Connectors → Discover, then search for Agility CMS. The button above goes straight there.

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

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.

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

Find it in Claude above copies that URL to your clipboard on the way.

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

Authenticate 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

GitHub Copilot for VS Code

Setup with OAuth authentication

Quick Install: Click the badge above for automatic setup, or follow the manual steps below.

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

Search for “Copilot: Configure MCP Servers” and add:

Server URL: https://mcp.agilitycms.com/api/mcp

Auth Type: OAuth

Authenticate

Follow the OAuth flow to connect your Agility CMS account

Cursor

AI-powered code editor

Quick Install: Click the badge above for automatic setup, or follow the manual steps below.

Open Settings

Go to Cursor Settings → Extensions → MCP Servers

Add MCP Server

Click “Add Server” and configure:

Name: Agility CMS

URL: https://mcp.agilitycms.com/api/mcp

Auth: OAuth

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

Add new MCP server with these details:

Server Name: Agility CMS MCP

Endpoint: https://mcp.agilitycms.com/api/mcp

Authentication: OAuth 2.0

Authorize Access

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

ChatGPT

OpenAI's ChatGPT — add as an app (Developer mode)

Note: As of December 2025, ChatGPT renamed connectors to apps. Custom MCP apps are added via Developer mode and are available to Pro, Plus, Business, Enterprise, and Education accounts on the web.

Enable Developer Mode

Go to Settings → Apps (Connectors) → Advanced settings → toggle on Developer mode

Create the Agility CMS App

In Settings → Apps, click Create and configure:

Name: Agility CMS

MCP Server URL: https://mcp.agilitycms.com/api/mcp

Authentication: OAuth

Authenticate via OAuth

Complete the OAuth authentication flow to connect your Agility CMS account

Use Across Chat

Enable the app on a conversation to call the Agility CMS tools directly in chat

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:

Server Name: Agility CMS MCP

Endpoint: https://mcp.agilitycms.com/api/mcp

Transport: streamable HTTP

Authentication: OAuth 2.0

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

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

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

Authenticate with Agility CMS

Follow the OAuth flow on first connection to grant Gemini CLI access

Start Using MCP Tools

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

📋 Prerequisites

•Active Agility CMS account with API access
•Valid Agility CMS instance with content models
•MCP-compatible tool (GitHub Copilot, Cursor, Windsurf, Claude, ChatGPT, Claude Code, Gemini CLI, 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.

View Documentation Contact Support