MCP server

Connect Boords to Claude, ChatGPT or another AI app so you can create and update your projects, scripts, storyboards and frames by asking in plain English.

See also: Claude and ChatGPT, overviews of what each AI app can do with Boords.

Connections are in beta and included on every plan, including Free, at no extra cost. Usage limits may apply in future.

How Connections work

Boords runs an MCP server. MCP is an open standard that lets an AI app use the tools inside another product. Once you connect, you can ask things like "Turn this script into a storyboard" or "Summarise the unresolved comments on the launch film storyboard", and your AI app does the work in Boords for you.

A connection uses your own Boords account. Your AI app can see what you can see, across every team you belong to, including teams you join later. What it can change depends on your role:

• Owner, Admin or Full access can create and edit projects, scripts, storyboards and frames through a connection.
• Owner or Admin is needed to read, add, edit or delete comments through a connection.
• Restricted members and guests can read through a connection but can't make changes, even where they can edit in the app.

See Team users and roles for how roles work.

You set up Connections in Settings → Team → Connections.

Before you start

You'll need:

• A Boords account on any plan, including Free. Your AI app works within your plan's limits.
• An AI app that supports remote MCP servers. Boords has guided setup for Claude, ChatGPT and Claude Code. Other tools, such as Cursor, work with the server URL.

You don't need an API key. You sign in to Boords from your AI app and approve access once.

Connect Claude

Boords is listed in Claude's connector directory. This works on claude.ai and in the Claude desktop app.

1. Open Boords in Claude's connector directory. You can also go to Settings → Team → Connections, pick Claude and click Add to Claude
2. Click Connect in Claude, sign in to Boords, then approve access

Boords now works in every Claude chat.

If you're in a Claude Team or Enterprise organization, an Owner or Primary Owner enables Boords for the organization first. If they haven't, click Request on the Boords listing to ask them. Each person then connects their own Boords account.

Connect ChatGPT

In ChatGPT, you add Boords as a custom MCP server. You don't need to turn on Developer mode.

1. In ChatGPT on the web, open Plugins

2. Click the plus button, then Add custom MCP server

3. Name it Boords, and under Connection paste this URL:

   https://app.boords.com/mcp
   

4. Choose OAuth for authentication

5. Tick I understand and want to continue on the warning, then click Create as a plugin. ChatGPT sends you to Boords to sign in and approve access

To use Boords in a chat, type @ and pick Boords. ChatGPT applies your pick to that message, so pick Boords again when you start new Boords work.

Which ChatGPT plans can add custom MCP servers, and whether they can make changes, is set by OpenAI. See OpenAI's guide to MCP apps in ChatGPT for the current rules. On a ChatGPT Business workspace, an admin or owner adds Boords for the workspace.

Connect Claude Code

1. Open a terminal and run:

   claude mcp add boords --scope user --transport http https://app.boords.com/mcp
   

2. Start Claude Code and type /mcp

3. Choose boords, then Authenticate. A browser tab opens for you to sign in to Boords and approve access

Boords now works in every Claude Code session.

Connect another app

Any tool that supports remote MCP servers with OAuth sign-in will work. Give it this server URL and choose OAuth if it asks how to sign in:

https://app.boords.com/mcp

When the tool asks you to sign in, use your Boords account and approve access.

Approving access

When you connect, Boords shows an approval screen with the account you're signed in as and the access the app has asked for:

• Read: view projects, scripts, storyboards, frames, assets, comments and teams you can access
• Read and write: create and update projects, scripts, storyboards, frames, images, frame order and comments

If an app hasn't been verified by Boords, you'll see a warning and need to confirm you started the connection yourself. Only continue if you did.

Your role still applies on top of the access you approve (see How Connections work). A connection stays active until you disconnect it or your AI app's sign-in expires.

What your AI app can do

With a connection, your AI app can work with:

• Projects: list, create and update projects
• Scripts: create, edit, duplicate, archive and restore scripts, and save versions
• Storyboards: create storyboards, including frames from a script, and update their details. Your AI app gets a link to open each storyboard in Boords
• Frames: add, update, delete and reorder frames, and attach images, including images made in another tool
• Asset Library: add, rename, file and delete images and folders in the Asset Library
• Comments: read, add, update and delete comments, and @mention teammates. Comments need an Owner or Admin role
• Notifications and activity: read and mark your notifications, and read your team's activity feed if your plan includes the Activity Log

Anything destructive, such as deleting a frame or a folder, needs an explicit confirmation before it runs.

What's not available yet

Boords' own image generation, restyling, styles and webhook settings aren't available through a connection. Use the app for those, or the Boords API and webhooks for automation.

Managing connections

Every app you've connected is listed under Connected tools in Settings → Team → Connections, with its access level, when you connected it and when it was last used.

Click Disconnect to remove an app. It loses access to Boords immediately. To use it again, connect it from scratch.

Connections belong to you, not your team. Each teammate connects their own account, and you only see your own connections.

Troubleshooting

My AI app says I've reached a plan limit

Your AI app has the same limits as your plan in the app. If you're on Free and hit the storyboard, frame or script limit, upgrade your plan and ask again.

My AI app can't find a project

Your AI app can only see what you can see in Boords. Check that you're a member of the team and project, and that you signed in with the right Boords account when you connected.

My AI app can't make changes

Check two things. First, your role: making changes through a connection needs an Owner, Admin or Full access role, and comments need Owner or Admin. Restricted members and guests can read only (see Team users and roles). Second, the connection's access level, shown under Connected tools in Settings → Team → Connections. A connection with Read access can't make changes.

I can't connect Boords in Claude

If you're in a Claude Team or Enterprise organization, an Owner or Primary Owner has to enable Boords in your organization's connector settings first. Click Request on the Boords listing to ask them. If your organization doesn't allow directory connectors, ask an Owner to add Boords as a custom connector with the server URL https://app.boords.com/mcp.

I'm being asked to sign in again

Your connection may have been disconnected, or your AI app's sign-in may have expired. Sign in and approve access again from your AI app.