Connect an AI app

Use Wordsmith from ChatGPT, Claude, Cursor and other AI apps that support MCP.

You can connect Wordsmith to an AI app such as ChatGPT, Claude or Cursor. The app can then work in Wordsmith for you. It can ask your Wordsmith agents, review and draft documents, search your repositories and case law, build reports, and manage tasks and files.

The app connects over MCP (Model Context Protocol), the standard these apps use to call tools in other services. You add Wordsmith once, sign in, and approve what the app may do. The MCP server reference lists every tool.

Before you start

Your role must allow it. Admins and full users can connect apps by default. Viewers cannot. An admin can allow it in a custom role with the Connect AI apps over MCP permission, under Settings → Roles.

The MCP server URL is https://mcp.wordsmith.ai/mcp.

The app acts as you. It can only reach what you can reach in Wordsmith, and only within what you approve. New files it creates go to your private space.

ChatGPT

Custom apps with write access need a ChatGPT Business, Enterprise or Edu workspace. OpenAI’s guide, Developer mode and full MCP connectors in ChatGPT, has the current menu names.

1. Turn on developer mode for the workspace

   A ChatGPT workspace admin or owner turns on developer mode in the workspace settings, under Permissions & roles. Enterprise and Edu admins can give it to selected roles only.

2. Create the Wordsmith app

   In ChatGPT, open Settings → Apps, turn on Developer mode under Advanced settings, and create an app. Name it Wordsmith, paste the MCP server URL, and choose OAuth as the authentication.

3. Sign in and approve

   ChatGPT opens the Wordsmith sign-in page. Sign in with your Wordsmith account, check the consent screen, and click Authorize.

4. Share it with the workspace

   Optional. A workspace admin can publish the tested app to the workspace. Members then add Wordsmith from the workspace’s apps without developer mode, and each member signs in with their own Wordsmith account.

To use it, add Wordsmith to a chat from the tools menu, or ask ChatGPT to use Wordsmith.

Attach files from ChatGPT

Attach a file to your ChatGPT message and ask ChatGPT to use it with Wordsmith, for example “review this NDA with our Wordsmith playbook”. ChatGPT hands the attachment to Wordsmith, which saves a copy in your private space. Up to 10 files can go with one question to a Wordsmith agent.

Files Wordsmith produces, such as a redline, a translation or a draft, stay in Wordsmith. ChatGPT gets a download link only when you ask for the file, and the link expires after 5 minutes.

The ChatGPT app directory

Wordsmith is not yet listed in ChatGPT’s app directory. Once it is, you can add it from the directory without developer mode, and this page will link to the listing.

Claude

Custom connectors work in Claude on the web, Claude Desktop and Cowork, on every Claude plan. On the Free plan you can add one custom connector. Anthropic’s guide, Getting started with custom connectors using remote MCP, has the current menu names.

1. Add the connector

   On a Pro or Max plan, open Settings → Connectors and add a custom connector. Name it Wordsmith and paste the MCP server URL. Leave the advanced OAuth fields empty: Wordsmith registers Claude on its own.

   On a Team or Enterprise plan, an owner adds the connector once for the organisation, in the organisation’s connector settings. Members then find Wordsmith in their connector list, marked Custom.

2. Connect your account

   Click Connect next to Wordsmith. Sign in with your Wordsmith account, check the consent screen, and click Authorize.

The connector is shared by claude.ai, Claude Desktop and Cowork, so you connect once. To use it in a chat, turn Wordsmith on in the chat’s tools menu.

Claude does not pass attached files to connectors. Claude can still create a Wordsmith file from text, such as a clause you paste, or from a public URL.

Claude Code

Add Wordsmith from a terminal:

claude mcp add --transport http wordsmith https://mcp.wordsmith.ai/mcp

Then run /mcp in Claude Code, select wordsmith and choose Authenticate. Your browser opens the Wordsmith sign-in page. Claude Code runs on your computer, so the consent screen names it An app on your computer and marks it as unverified. That is expected for apps that sign in through your own machine. Claude Code’s MCP guide covers scopes such as adding a server for one project only.

Claude Code can upload files from your computer to Wordsmith, so you can ask it to review or file a local document.

The Claude directory

Wordsmith is not yet listed in the Claude connector directory. Once it is, you can add it from Settings → Connectors → Browse connectors without pasting a URL, and this page will link to the listing.

Cursor

Open Cursor Settings → MCP and add a server, or add Wordsmith to your mcp.json (~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project):

{
  "mcpServers": {
    "wordsmith": {
      "url": "https://mcp.wordsmith.ai/mcp"
    }
  }
}

Cursor shows a button to log in next to Wordsmith. Click it, sign in, and approve the consent screen. Cursor’s MCP guide has more on configuring servers.

Like Claude Code, Cursor can upload files from your computer to Wordsmith.

Other MCP apps

Any app can connect if it supports remote MCP servers over Streamable HTTP and signs in with OAuth. Add Wordsmith’s MCP server URL, and the app finds the sign-in page on its own.

• Apps on your computer that sign in through a local address, such as VS Code or the MCP Inspector, work without setup. The consent screen names them An app on your computer.
• Web apps must be approved by Wordsmith before they can connect. If an app shows a registration error, ask [e-mail] to add it.

To build your own app on the REST API instead, see OAuth.

The consent screen

When you connect an app, Wordsmith shows a consent screen. It names the app, shows which Wordsmith account you are signed in with, and lists what the app is asking to do. It also shows the address Wordsmith will send you back to.

Approving grants everything on the list. To give an app less, configure the app to ask for fewer scopes. ChatGPT and Claude ask for the standard set below, which leaves out organisation administration.

If the screen says Wordsmith hasn’t verified the app, check that the address it names belongs to the app you meant to connect. Click Deny if it does not.

What each scope means

The screen shows one line per area. A line that lets the app change something also lets it read that area.

Scope	On the consent screen	Standard set
mcp:access	Use Wordsmith tools on your behalf.	Yes
me:read	Read your basic Wordsmith profile (name, email, organisation).	Yes
agents:read	See the Wordsmith agents you have access to.	Yes
sessions:read	Read the answers to questions you’ve asked your agents.	Yes
sessions:write	Ask your agents questions and read their answers.	Yes
files:read	See and download files you can access in Wordsmith.	Yes
files:write	Upload files to Wordsmith.	Yes
reviews:read	See your Wordsmith reviews and their findings.	Yes
reviews:write	Review documents and generate redlines from the reviews.	Yes
playbooks:read	See your Wordsmith playbooks.	Yes
playbooks:write	Create, edit and delete your playbooks, and change who they are shared with.	Yes
blueprints:read	See your Wordsmith blueprints.	Yes
blueprints:write	Change who your blueprints are shared with.	Yes
skills:read	See your Wordsmith skills and the files they bundle.	Yes
skills:write	Create, edit and delete your skills and the files they bundle.	Yes
repositories:read	See and search the repositories you can access.	Yes
repositories:write	Create, rename and delete repositories, add or remove their documents, and change who they are shared with.	Yes
reports:read	See your Wordsmith reports and their results.	Yes
reports:write	Create, edit, run, export and delete reports, and change who they are shared with.	Yes
tasks:read	See the tasks you have access to.	Yes
tasks:write	See, create, update and delete tasks, their comments, files and links, change who they’re shared with, and reply to requesters.	Yes
research:read	Search and read case law and legislation.	Yes
directory:read	See the people, teams, roles and company profiles in your organisation.	Yes
usage:read	See usage and value figures: your own, and your organisation’s if you may.	Yes
directory:admin	Administer your organisation where you are allowed to: company profiles, members, invites, roles and teams.	No
openid	Confirm which Wordsmith account you signed in with.	No
email	See your email address.	No

An app gets directory:admin only when it asks for it by name. ChatGPT Enterprise also asks for openid and email, to keep apps to your company’s email domain.

files:write does not include files:read: an app that can upload files cannot read your other files without files:read.

No scope adds to your own rights. With directory:admin, for example, the app can change only what you could change yourself as an admin.

Disconnect an app

To see and disconnect the apps you have connected:

1. In Wordsmith, open Settings.
2. Under Configurations, open Connected apps, next to Connectors.
3. Click Disconnect next to the app, and confirm.

The app loses access at once. To use it again, connect it again from the app.

Removing Wordsmith inside the app, for example deleting the connector in Claude, may not end its access. If the app does not tell Wordsmith, the connection stays valid and stays listed under Connected apps. To be sure an app has lost access, disconnect it there.

Connected apps appears if your role may connect apps or if you already have one connected. You can always disconnect an app, even after your role changes.

A connection also ends on its own 60 days after you approved it. The app then asks you to sign in again.

Troubleshooting

What you see	What to do
”Your role doesn’t allow this connection”	Ask an admin to add Connect AI apps over MCP to your role.
”You can’t connect an app while acting on behalf of someone”	Sign in to Wordsmith as yourself, then connect again.
A tool says it needs more access	The app’s connection is missing a scope, for example from an older connection. Disconnect the app and connect it again.
The app keeps asking you to sign in	The 60-day limit has passed, or the app was disconnected. Sign in again.