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

  1. In Claude, open Connectors in the settings.
  2. 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.
  3. A FlexSite sign-in page opens. Sign in with your FlexSite account.
  4. Review the permissions on the consent page and select Allow.
  5. 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:

PermissionWhat it allows
projects:readSee the organizations and projects on your FlexSite account
projects:createCreate projects in an organization you belong to
environments:readSee environment status, alerts, and configuration advisories
deployments:readSee the latest deployment and whether it failed
backups:readSee when database backups were taken
metrics:readSee Lighthouse quality scores
repository:readSee the FlexLab repository address and which branch each environment uses
sites:readRead pages and content on your sites that have AI agent access turned on
sites:writeCreate, edit and publish content, add menu links and clear caches on those sites, within what your FlexSite role allows
openid, email, profileShow which FlexSite account is connected

Disconnect

  1. In the FlexSite dashboard, open your user menu and select Connected apps.
  2. 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 seeWhat 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 changeAsk a project admin to change your role, or to make the change.
Claude asks you to sign in againThe connection was revoked or expired. Select Connect again and approve it.
A project is missing from the listCheck 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.