Skip to main content

How to authenticate with the Craft.io MCP server

Learn how to sign in with your Craft.io account, authorize the connection, and understand the access requirements.

Written by Maayan Ayalon

Craft.io’s MCP server allows compatible AI assistants to connect securely to your Craft.io data. Authentication uses your existing Craft.io account and permissions, with no API keys to create, copy, or store.

This guide explains what you need and walks you through signing in and authorizing the connection.


Before you begin

You will need:

  • A Craft.io account

  • An Enterprise account with MCP enabled, or an active Craft.io trial

  • An editor seat - contributor seats do not include MCP access

For Enterprise accounts, MCP is disabled by default and must be enabled by an account admin. During a trial, MCP is enabled automatically.

💡 Using Claude? Follow ⁠Connect Craft.io to Claude with the official connector for the simplest way to connect.


Connecting to the Craft.io MCP server

When you connect an AI assistant to the Craft.io MCP server, you'll be prompted to sign in with your Craft.io account.

Follow these steps:

  1. Follow the sign-in link your AI assistant shows you.

  2. Log in to Craft.io

  3. Review and accept the terms and privacy policy. Note - you only see this the first time.

  4. You're connected. Return to your AI assistant to start using it.​



Your access and permissions

When you sign in, MCP follows your existing Craft.io permissions. By default, the connection provides read and write access to the workspaces, portfolios, and feedback portals you can already access.

Account admins can apply additional restrictions for individual users from the Account Manager:

  • Set MCP access to read-only

  • Limit access to selected workspaces, portfolios, or feedback portals

Any changes take effect with the user’s next AI request.


Common errors

  • Your account is not on an Enterprise plan or trial
    MCP is available for Enterprise accounts and active Craft.io trials. Contact your account admin or Craft.io Customer Success representative to discuss your options.

  • You do not have an editor seat
    Ask your Craft.io account admin to assign you an editor seat. Contributor seats do not include MCP access.

  • MCP is disabled for your organization
    For Enterprise accounts, an account admin must enable MCP from the Account Manager. Ask your admin to enable it or contact your Craft.io Customer Success representative.



What comes next

Need more guidance? 🙋 Our LIVE support team (at the bottom right corner of your screen) replies to ANY question!

Did this answer your question?