> ## Documentation Index > Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://wordsmithai.mintlify.site/mcp-server.md) 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](https://help.openai.com/en/articles/12584461-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](#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 > [!NOTE] > > 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](https://support.claude.com/en/articles/11175166-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](#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: ```bash theme={null} 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](https://code.claude.com/docs/en/mcp) 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 > [!NOTE] > > 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): ```json theme={null} { "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](https://cursor.com/docs/context/mcp) 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 [support@wordsmith.ai](mailto:support@wordsmith.ai) to add it. To build your own app on the REST API instead, see [OAuth](https://wordsmithai.mintlify.site/oauth.md). ## 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. > [!WARNING] > > 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. | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.