Connect Claude to FlexSite
Applies to: All
Overview
The FlexSite connector lets Claude read and manage the projects on your FlexSite account. It works in claude.ai, Claude Desktop, and the Claude mobile apps. Claude uses it when your question is about FlexSite, so you can ask in everyday language.
Before you start
- A FlexSite account. Sign up if you do not have one.
- To create or edit content: a Drupal environment with AI agent access turned on. See Turn On AI Agent Access for a Drupal Site.
- To create a project: permission to create projects in the organization, and enough credits.
Steps — connect
- In Claude, open Connectors in the settings.
- Search the directory for FlexSite and select Connect. If FlexSite is not listed yet, choose Add custom connector and enter
https://agents.flexsite.io/mcp. - A FlexSite sign-in page opens. Sign in with your FlexSite account.
- Review the permissions on the consent page and select Allow.
- Back in Claude, ask: “List my FlexSite projects.”
Example prompts
- “Is my FlexSite site up, and did the last deployment finish?”
- “Show the open alerts on my marketing site.”
- “Create a new Drupal 11 site on FlexSite and tell me when the dev environment is ready.”
- “Add an unpublished page about our spring opening on the dev environment.”
- “Will this composer.json work on FlexSite?” (paste the file)
What Claude can and cannot do
- Read: organizations, projects, environment status, alerts and advisories, the latest deployment, database backups, Lighthouse scores, the FlexLab repository address, and the content on Drupal sites with AI agent access.
- Change: create a project (after showing a preview with the credits it costs), create and edit content, publish content, build Canvas pages, add menu links and DAM images, and clear the cache. Claude asks for your approval before each change unless you allowed that tool to run without asking.
- Cannot: delete projects or environments, change billing, push code, or import a database. Do those in the dashboard or with the FlexSite CLI.
- WordPress: Claude can create WordPress projects and report their status. Editing site content is available on Drupal only.
The full list is in the AI Agent Tools Reference.
Permissions
The consent page lists what the connection may do. Each permission matches one of these:
| Permission | What it allows |
|---|---|
projects:read | See the organizations and projects on your FlexSite account |
projects:create | Create projects in an organization you belong to |
environments:read | See environment status, alerts, and configuration advisories |
deployments:read | See the latest deployment and whether it failed |
backups:read | See when database backups were taken |
metrics:read | See Lighthouse quality scores |
repository:read | See the FlexLab repository address and which branch each environment uses |
sites:read | Read pages and content on your sites that have AI agent access turned on |
sites:write | Create, edit and publish content, add menu links and clear caches on those sites, within what your FlexSite role allows |
openid, email, profile | Show which FlexSite account is connected |
Disconnect
- In the FlexSite dashboard, open your user menu and select Connected apps.
- Select Revoke next to the connection. It stops working on its next request.
You can also remove the connector in Claude’s settings. To connect again, repeat the steps above.
Troubleshooting
| What you see | What to do |
|---|---|
| “AI agent access is not turned on for this environment.” | An admin turns it on from the environment page. See Turn On AI Agent Access for a Drupal Site. |
| Claude says your role does not allow a change | Ask a project admin to change your role, or to make the change. |
| Claude asks you to sign in again | The connection was revoked or expired. Select Connect again and approve it. |
| A project is missing from the list | Check that you are signed in to Claude with the FlexSite account that belongs to that organization. |
Privacy
Claude sends FlexSite only what each request needs, such as a project id or the text of a page you asked for. FlexSite does not receive your conversation. See the privacy policy.