{"article":{"id":46210076980365,"url":"https://superhuman-mail.zendesk.com/api/v2/help_center/en-us/articles/46210076980365.json","html_url":"https://help.superhuman.com/hc/en-us/articles/46210076980365-Connect-to-the-Superhuman-Docs-MCP","author_id":35474998085645,"comments_disabled":true,"draft":false,"promoted":false,"position":3,"vote_sum":0,"vote_count":6,"upvote_count":3,"downvote_count":3,"section_id":46128104254989,"created_at":"2026-05-28T12:12:40Z","updated_at":"2026-11-17T00:55:29Z","name":"Connect to the Superhuman Docs MCP","title":"Connect to the Superhuman Docs MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-17T00:55:29Z","user_segment_id":null,"permission_group_id":1715972,"content_tag_ids":[],"label_names":["docs"],"body":"<p class=\"no-margin\">The Superhuman Docs MCP (Model Context Protocol) is a connection layer that lets AI clients, such as Cursor and Claude, read and write to your Docs using plain-language prompts instead of clicking through the Docs UI: you describe what you want in the chat window of your chosen client, and the AI carries it out directly in your doc, acting on your behalf with the same access to your Superhuman Docs workspace that you have. This article walks you through connecting your preferred AI tool to the Superhuman Docs MCP; once you’ve connected, see <a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210102879629\" target=\"_blank\" rel=\"noopener noreferrer\">Using the Superhuman Docs MCP</a> for guidance and examples.</p><div class=\"callout callout--style-info callout--type-5 callout--size-medium\"><p><strong>Note:</strong> If you already connected to the Coda MCP before the launch of Superhuman Docs MCP, your existing connections will continue to work for the time being. However, we encourage you to connect to the Superhuman Docs MCP as soon as you’re able. All new features will be introduced to the Docs MCP only, and the Coda MCP will eventually be deprecated.</p></div><p> </p><hr><h2 id=\"h_01KN2W9E76S32BFQA75X5Z121E\"><strong>Supported clients</strong></h2><p class=\"no-margin\">The table below lists the clients for which Superhuman Docs MCP is currently well supported. We’ve also included the method of authentication available for each client. To learn more about these different authentication methods, see <a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210118248205\" target=\"_blank\" rel=\"noopener noreferrer\">Security recommendations for the Docs MCP</a>.</p><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table class=\"wysiwyg-table-resized\">\n<colgroup>\n<col style=\"width: 60%;\">\n<col style=\"width: 40%;\">\n</colgroup>\n<thead><tr>\n<th scope=\"col\">Supported client</th>\n<th scope=\"col\">Method of authentication</th>\n</tr></thead>\n<tbody>\n<tr>\n<td><a href=\"https://chatgpt.com/\" target=\"_blank\" rel=\"noopener noreferrer\">ChatGPT</a></td>\n<td>OAuth 2</td>\n</tr>\n<tr>\n<td>\n<a href=\"https://claude.com/product/overview\" target=\"_blank\" rel=\"noopener noreferrer\">Claude</a> (including Claude Code, Claude Cowork, and Claude Chat)</td>\n<td>OAuth 2</td>\n</tr>\n<tr>\n<td><a href=\"https://www.microsoft.com/en-us/microsoft-365-copilot/microsoft-copilot-studio\" target=\"_blank\" rel=\"noopener noreferrer\">CoPilot Studio</a></td>\n<td>Personal Access Tokens</td>\n</tr>\n<tr>\n<td><a href=\"https://cursor.com/\" target=\"_blank\" rel=\"noopener noreferrer\">Cursor</a></td>\n<td>OAuth 2</td>\n</tr>\n<tr>\n<td><a href=\"https://chatgpt.com/features/codex?utm_source=google&amp;utm_medium=paidsearch_competitor&amp;utm_campaign=GOOG_M_SEM_GCP_Codex_TEM_BAU_ACQ_PER_MIX_ALL_NAMER_US_EN_111325&amp;utm_term=claude%20code&amp;utm_content=188016694053&amp;utm_ad=782421044810&amp;utm_match=e&amp;gad_source=1&amp;gad_campaignid=23230295416&amp;gbraid=0AAAAA-I0E5eib9gQukcFjdFJYUXelt0w7&amp;gclid=Cj0KCQiAi9rJBhCYARIsALyPDtsMOU40vNOzNbBrz0-I_ahSG6No5lE9V_3UlxIYplc433yta0PUxqUaAr_uEALw_wcB\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAI Codex</a></td>\n<td>OAuth 2</td>\n</tr>\n<tr>\n<td><a href=\"https://antigravity.google/\" target=\"_blank\" rel=\"noopener noreferrer\">Google Antigravity</a></td>\n<td>Personal Access Tokens</td>\n</tr>\n</tbody>\n</table></figure><p class=\"no-margin\">You can find specific instructions for connecting to each of these clients in the subsequent sections.</p><p class=\"no-margin\"> </p><h2 id=\"h_01KN2XDM483HK3B17QAZQR2JMX\"><strong>Connect ChatGPT with Docs MCP</strong></h2><p class=\"no-margin\">Follow the steps below to connect ChatGPT with Docs MCP:</p><ol>\n<li data-list-item-id=\"e3a33a50875fbb8791898e3a6a6d08a70\"><p class=\"no-margin\">Within ChatGPT, click into the <strong>Plugins</strong> tab of the left panel.</p></li>\n<li data-list-item-id=\"e0d39798340755691d30035e2adfb959b\"><p class=\"no-margin\">Enter “Superhuman Docs” in the search bar.</p></li>\n<li data-list-item-id=\"e06bd71a8d1dd532641c2e52623c1bf90\">\n<p class=\"no-margin\">Select <strong>Superhuman Docs</strong> from the search results, then click <strong>Install plugin</strong>.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"efc2e38ba038d567152a9c56737765719\"><p class=\"no-margin\"><em>Note: If you see <strong>Disabled by admin</strong> instead of <strong>Connect</strong>, this likely indicates that the admin of your account has disabled connecting to new apps. We suggest contacting your admin and requesting they enable the Coda app for you or your org. To learn more, see </em><a href=\"https://help.openai.com/en/articles/11487775-apps-in-chatgpt?utm_source=chatgpt.com#app-directory\" target=\"_blank\" rel=\"noopener noreferrer\"><em>OpenAI’s documentation on apps in ChatGPT</em></a><em>.</em></p></li></ul>\n</li>\n<li data-list-item-id=\"e81b2a72bba8213c0dc094a5e23e2bbc5\"><p class=\"no-margin\">A new tab will open to complete the authentication process. If prompted, sign in to Superhuman Docs.</p></li>\n<li data-list-item-id=\"ed0b8e5d693a1fddfc0b340f2bb52f4a7\"><p class=\"no-margin\">Choose whether to grant this connection <strong>Full access</strong> or <strong>Limited access</strong> to your docs, folders, and workspaces. If you choose <strong>Limited access</strong>, select the workspaces, folders, and/or docs that this connection will have access to. You can filter by workspace or find shared content in the <strong>Shared with you</strong> tab. Once you’ve made your selections, click <strong>Save selection</strong>.</p></li>\n<li data-list-item-id=\"e6d7e518461c7e61f051efd0588bd2837\"><p class=\"no-margin\">Finally, click <strong>Accept</strong> to complete the authentication.</p></li>\n<li data-list-item-id=\"e014e29fc5a07628aaf01808f707ef6b5\"><p class=\"no-margin\">Once authentication has been completed, you’ll be redirected back to ChatGPT and should see a <strong>Superhuman Docs is installed</strong> confirmation.</p></li>\n</ol><p class=\"no-margin\">You should now be successfully connected to the Docs MCP and can start using it to work with Superhuman Docs within your chats.</p><p class=\"no-margin\"> </p><h2 id=\"h_01KN2WCG6N7RNF022XT973CRCD\"><strong>Connect Claude Chat &amp; Cowork with Docs MCP</strong></h2><div class=\"callout callout--style-info callout--type-5 callout--size-medium\"><p><strong>Note:</strong> Superhuman Docs MCP is now available as a native connector in Claude, allowing for an even easier connection. Check out the instructions below.</p></div><p class=\"no-margin\">To connect Claude Chat or Cowork to the Superhuman Docs MCP:</p><ol>\n<li data-list-item-id=\"e015ae2fbc10fa50181e352bf86a7ae3c\"><p class=\"no-margin\">Ensure you are logged in to Claude.</p></li>\n<li data-list-item-id=\"e5956f66e0044384f830b082181d81222\"><p class=\"no-margin\">Go to the <a href=\"https://claude.ai/directory/connectors/superhuman-docs\" target=\"_blank\" rel=\"noopener noreferrer\">native Superhuman Docs connector in Claude</a>.</p></li>\n<li data-list-item-id=\"e1c4b1956ee4a1f695d3bae3ba2062fd5\">\n<p class=\"no-margin\">Click the <strong>Connect</strong> button. </p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"ea6bc95464bf00b52f19894cdb528bc41\"><p class=\"no-margin\"><em>If the <strong>Connect</strong> button is not available, this most likely means that your Claude account is part of a Team or Enterprise plan, and your admin has not yet enabled this connector for your organization. In this case, we suggest reaching out to your admin to request access to this connector, then resuming the connection process as described here. See the FAQs below for more info on this.</em></p></li></ul>\n</li>\n<li data-list-item-id=\"ee6cdd0f4bd060e8048f3f5af8562fa96\"><p class=\"no-margin\">A new tab will open to complete the authentication process. If prompted, sign in to Superhuman Docs.</p></li>\n<li data-list-item-id=\"ec3384296c5cddbbcfbaa6d6529877b7a\"><p class=\"no-margin\">Choose whether to grant this connection <strong>Full access</strong> or <strong>Limited access</strong> to your docs, folders, and workspaces. If you choose <strong>Limited access</strong>, select the workspaces, folders, and/or docs that this connection will have access to. You can filter by workspace or find shared content in the <strong>Shared with you</strong> tab. Once you’ve made your selections, click <strong>Save selection</strong>.</p></li>\n<li data-list-item-id=\"eba1b65ba591e87f378eaa7222d5dd148\"><p class=\"no-margin\">Finally, click <strong>Accept</strong> to complete the authentication.</p></li>\n<li data-list-item-id=\"e03139ada7b0e79107f86e3086cae41bf\"><p class=\"no-margin\">Once authorized, you’re all set. You can start taking actions in Docs with Claude!</p></li>\n</ol><p class=\"no-margin\"> </p><h2 id=\"h_01KN2W9E7XWJE6DSNP47BYAR5D\"><strong>Connect Claude Code with Docs MCP</strong></h2><p class=\"no-margin\">To connect Claude Code to the Superhuman Docs MCP, follow these steps:</p><ol><li data-list-item-id=\"eccfdc2ff6de8427eb903bf5f8ef4ea3e\"><p class=\"no-margin\">To start, open a fresh terminal window and run the following block:</p></li></ol><pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">claude mcp add --transport http SuperhumanDocs https://docs.superhuman.com/apis/mcp</code></pre><ol start=\"2\">\n<li data-list-item-id=\"ea2565f89fa7b06ac73eb0cdc239b0b68\"><p class=\"no-margin\">Once the above has run, type <code>Claude</code> into your terminal and hit <strong>Enter</strong>.</p></li>\n<li data-list-item-id=\"e5514a3a25f622cceca71a6c05fd02de0\"><p class=\"no-margin\">Then type <code>/mcp</code> into the terminal and hit <strong>Enter</strong> again.</p></li>\n<li data-list-item-id=\"ef69ed016255ceef88ac8cd7bf725ab32\"><p class=\"no-margin\">You should now see a notice that Superhuman Docs MCP needs authentication. Click <strong>Enter</strong> and select <strong>Authenticate</strong>.</p></li>\n<li data-list-item-id=\"e06b31fb1c8362aaa3b921c51027445fe\">\n<p class=\"no-margin\">This will open a browser window to complete authentication. If prompted, sign in to your Superhuman Docs account.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"e2fce70156dddb00e2bb1f9f9afa37de7\"><p class=\"no-margin\"><em>Note: You’ll also see that the redirect URL is </em><code><em>localhost</em></code><em>, which is expected based on how Claude handles OAuth.</em></p></li></ul>\n</li>\n<li data-list-item-id=\"e2a680b72ae4b982f873876c870641307\"><p class=\"no-margin\">Choose whether to grant this connection <strong>Full access</strong> or <strong>Limited access</strong> to your docs, folders, and workspaces. If you choose <strong>Limited access</strong>, select the workspaces, folders, and/or docs that this connection will have access to. You can filter by workspace or find shared content in the <strong>Shared with you</strong> tab. Once you’ve made your selections, click <strong>Save selection</strong>.</p></li>\n<li data-list-item-id=\"e79fd7e9840361edde3c95ddcd3f8fc5c\"><p class=\"no-margin\">Hit <strong>Accept</strong>. You should then see an <strong>Authentication Successful</strong> confirmation.</p></li>\n<li data-list-item-id=\"e0603e18d061757b8bc3672a1ba6950b9\"><p class=\"no-margin\">To confirm connection to the Docs MCP, return to your terminal window and enter the following:</p></li>\n</ol><pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">Are you connected to the Superhuman Docs MCP?</code></pre><p class=\"no-margin\">If successful, you’ll see a success message with Docs MCP tools. You can now start building in Docs using Claude Code!</p><div class=\"callout callout--style-info callout--type-5 callout--size-medium\">\n<p><strong>Tip:</strong></p>\n<ul>\n<li data-list-item-id=\"ee0a5db9179842831f32b20341a54d725\"><p class=\"no-margin\">If you have already used another MCP that accesses Coda: Use <code>claude mcp remove &lt;mcp-name&gt;</code> in this case.</p></li>\n<li data-list-item-id=\"e3013ecdac20554548338139a5a3d745f\"><p class=\"no-margin\">If you have directories named “Coda” in your filepath: Change the directory and try again.</p></li>\n</ul>\n<p>Find more details in <a href=\"https://code.claude.com/docs/en/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Claude’s MCP documentation</a>.</p>\n</div><p class=\"no-margin\"> </p><h2 id=\"h_01KQX90KTGW1DYGE1PMH391K1V\"><strong>Connect Copilot Studio with Docs MCP</strong></h2><p class=\"no-margin\">To connect Copilot Studio with the Superhuman Docs MCP, you will need to authenticate via Personal Access Tokens from your Superhuman Docs account. Follow the steps below to learn more:</p><ol>\n<li data-list-item-id=\"e8e5e78dfd8ea5bb22997f761a37f036e\"><p class=\"no-margin\">First, you’ll need to generate a Personal Access Token from your Superhuman Docs account page. Open your <a href=\"https://docs.superhuman.com/account#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">account’s API settings</a>, or scroll to the <strong>API settings</strong> section of your account page.</p></li>\n<li data-list-item-id=\"ef001cd3e63e423b1b7b37524ccc6909d\"><p class=\"no-margin\">Click <strong>Generate API token</strong>.</p></li>\n<li data-list-item-id=\"e36f56b304bf23effcf5a32340cb1085e\"><p class=\"no-margin\">Give your token a memorable name and choose the type of access.</p></li>\n<li data-list-item-id=\"e451bc979fe86b16ab010428d475bb455\"><p class=\"no-margin\">Ensure that the <strong>MCP</strong> option is selected.</p></li>\n<li data-list-item-id=\"e7177500f371ae2739035ad2c76a2fd4c\"><p class=\"no-margin\">Click the <strong>Generate API token</strong> button to create the token.</p></li>\n<li data-list-item-id=\"e93386181f997f8b9526b0899b00d281a\">\n<p class=\"no-margin\">Once created, click the <strong>Copy</strong> button to copy it to your clipboard.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"e3627c8113cb4b3f07a201c8039142b3d\"><p class=\"no-margin\"><em>Learn more in </em><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210310809613\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Generate API tokens for Docs</em></a><em>.</em></p></li></ul>\n</li>\n</ol><figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"width: 75%;\"><img style=\"aspect-ratio: 1842/1080;\" src=\"https://help.superhuman.com/hc/article_attachments/49824757289613\" alt=\"Generate API token button on the API connections page of Superhuman Docs account settings\" width=\"1842\" height=\"1080\"></figure><ol start=\"7\">\n<li data-list-item-id=\"e880e476ac1d70ec010f7b88943ade8c8\"><p class=\"no-margin\">Next, within Copilot Studio, open the agent you want to connect to the MCP.</p></li>\n<li data-list-item-id=\"eb925c7dff1b358f4a9eab72ad87c97de\"><p class=\"no-margin\">From the menu across the top of the agent page, select <strong>Tools</strong>, then click the <strong>+ Add a tool</strong> button.</p></li>\n<li data-list-item-id=\"ed905c6af2c258f58edb641712d1c7b16\"><p class=\"no-margin\">Within the <strong>Create new</strong> options, select <strong>Model Context Protocol</strong>.</p></li>\n<li data-list-item-id=\"edc30d08b62fddfdc36552e3f3ecce7a2\">\n<p class=\"no-margin\">Enter the following info:</p>\n<ul>\n<li data-list-item-id=\"e08b2d659aba411cfae89c6e992bc3fd1\"><p class=\"no-margin\"><strong>Server name</strong> and <strong>Server Description</strong>: fill these in as you see fit (for instance, “Superhuman Docs MCP” and “Superhuman Docs MCP to read and write to docs”)</p></li>\n<li data-list-item-id=\"e3ea061e17515a944532c65b6d5f70f15\"><p class=\"no-margin\"><strong>Server URL</strong>: <code>https://docs.superhuman.com/apis/mcp</code></p></li>\n<li data-list-item-id=\"e118ad79ad82ba2fda4146b77d1ea0873\"><p class=\"no-margin\"><strong>Authorization</strong>: Select the <strong>API Key</strong> option. Then for the <strong>Type</strong> choose <strong>Header</strong>, and for the <strong>Header name</strong> enter <code>Authorization</code></p></li>\n</ul>\n</li>\n<li data-list-item-id=\"e44852835b4984d1b2b0ef6f53399b86b\"><p class=\"no-margin\">Once all the above info has been entered, hit <strong>Create</strong>.</p></li>\n<li data-list-item-id=\"e089f91b93e77c6eaba4bbbe72e15fe49\"><p class=\"no-margin\">You’ll then see the newly added tool, but you’ll notice it’s not yet connected. Click on <strong>Not connected</strong> and select <strong>Create new connection</strong>.</p></li>\n<li data-list-item-id=\"ec7bbe323a68cda514dd04e4a53a4f569\">\n<p class=\"no-margin\">In the hidden field, enter the following string: <code>Bearer Your-Docs-Auth-Token</code> - making sure to replace <strong>Your-Docs-Auth-Token</strong> with the token you generated and copied above.</p>\n<ul><li data-list-item-id=\"eac2a645758daf0ae9e3ae808489fc43c\"><p class=\"no-margin\">For instance, <code>Bearer 1bxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</code></p></li></ul>\n</li>\n<li data-list-item-id=\"e66d538eac5a11f9fb6a1d1875890a637\"><p class=\"no-margin\">Hit the <strong>Create</strong> button to finalize the connection.</p></li>\n</ol><p class=\"no-margin\"> </p><h2 id=\"h_01KN2W9E842WCJ450DE8XF9SS9\"><strong>Connect Cursor with Docs MCP</strong></h2><p class=\"no-margin\">To connect Cursor with Superhuman Docs MCP, follow these steps:</p><ol>\n<li data-list-item-id=\"e8e6c109f4d6b4e5c112cec91571c687e\"><p class=\"no-margin\">Within your Cursor app, open <strong>Cursor Settings</strong> → <strong>Tools &amp; MCP</strong>.</p></li>\n<li data-list-item-id=\"e13a3790f78b3aa834d35b86dcfd74b41\">\n<p class=\"no-margin\">Click <strong>New MCP Server</strong>. This will open a new mcp.json file.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"ea632dbfce2afa62e7657b4bc9df11d02\"><p class=\"no-margin\"><em>Tip: Only enable the MCPs you are currently working with to save context and improve agent accuracy</em></p></li></ul>\n</li>\n<li data-list-item-id=\"e8058784335f34019504939d730cabdd2\"><p class=\"no-margin\">Inside your mcp.json file in Cursor, insert the following code:</p></li>\n</ol><pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">{\n  \"mcpServers\": {\n    \"SuperhumanDocs\": {\n      \"url\": \"https://docs.superhuman.com/apis/mcp\"\n    }\n  }\n}</code></pre><ol start=\"4\"><li data-list-item-id=\"e297f438155c9b8f3c0dfda88e89f439e\">\n<p class=\"no-margin\">Once you’ve made the above edits, the file should be saved automatically, and you should now be connected to the Superhuman Docs MCP. You can verify by checking the tools list (under <strong>Tools &amp; MCP</strong>) or asking Cursor about your tools in Docs.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"e4b1e49ff75b3d27fbd7e897562c9d91b\"><p class=\"no-margin\"><em>Tip: If you don’t see your MCP show up at this stage, restart Cursor.</em></p></li></ul>\n</li></ol><p class=\"no-margin\">You can now use the Cursor agent to put the Docs MCP to work.</p><div class=\"callout callout--style-info callout--type-5 callout--size-medium\"><p><strong>Note:</strong> To learn more about connecting MCPs in Cursor, please refer to <a href=\"https://cursor.com/docs/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Cursor’s MCP documentation</a>.</p></div><p class=\"no-margin\"> </p><h2 id=\"h_01KN2W9E8A8K536C10N7B2AD5G\"><strong>Connect OpenAI Codex CLI with Docs MCP</strong></h2><p class=\"no-margin\">OpenAI Codex can now connect with Superhuman Docs MCP via OAuth. To connect, follow these steps:</p><ol><li data-list-item-id=\"e5d40e16db291bb55d3b5553e0d2d7d2f\"><p class=\"no-margin\">Open your terminal and paste the following code:</p></li></ol><pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">codex mcp add SuperhumanDocs --url https://docs.superhuman.com/apis/mcp</code></pre><ol start=\"2\"><li data-list-item-id=\"e63310fa16ca64428a04d283acc2f7071\"><p class=\"no-margin\">Start Codex by typing <code>codex</code>.</p></li></ol><p class=\"no-margin\">Once you’re connected, you can <a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210102879629\" target=\"_blank\" rel=\"noopener noreferrer\">start using the Docs MCP</a>.</p><div class=\"callout callout--style-info callout--type-5 callout--size-medium\"><p><strong>Note:</strong> To learn more about connecting MCPs in Codex, please refer to <a href=\"https://developers.openai.com/codex/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">OpenAI’s Codex MCP documentation</a>.</p></div><p class=\"no-margin\"> </p><h2 id=\"h_01KN2W9E8EP8YK1GK8QRKEANKK\"><strong>Connect Google Antigravity with Docs MCP</strong></h2><p class=\"no-margin\">To connect Google Antigravity with Superhuman Docs MCP, you will need to use Personal Access Tokens from your Superhuman Docs account page. Follow the steps below to learn more.</p><p class=\"no-margin\">To connect Google Antigravity with Superhuman Docs MCP, follow these steps:</p><ol>\n<li data-list-item-id=\"eb208bf79a4ab7c15e1b50af1183ff54e\"><p class=\"no-margin\">First, you’ll need to generate a Personal Access Token from your Superhuman Docs account page. Open your <a href=\"https://docs.superhuman.com/account#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">account’s API settings</a>, or scroll to the <strong>API settings</strong> section of your account page.</p></li>\n<li data-list-item-id=\"e83d0de1eaf75656a40151ebe54ca765d\"><p class=\"no-margin\">Click <strong>Generate API token</strong>.</p></li>\n<li data-list-item-id=\"e9a36ba63ed73769b7edd2e3f571b991a\"><p class=\"no-margin\">Give your token a memorable name and choose the type of access.</p></li>\n<li data-list-item-id=\"e1cebc41ac644cf0d87ffd873877ee7cf\"><p class=\"no-margin\">Ensure that the <strong>MCP</strong> option is selected.</p></li>\n<li data-list-item-id=\"ef1c766ae3a000eb0d6f61882d97e5928\"><p class=\"no-margin\">Click the <strong>Generate API token</strong> button to create the token.</p></li>\n<li data-list-item-id=\"e315692c84d80c145560ddbb430d6d965\">\n<p class=\"no-margin\">Once created, click the <strong>Copy</strong> button to copy it to your clipboard.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"ed41dcf7c07d70c246f9f2bb4608d4985\"><p class=\"no-margin\"><em>Learn more in </em><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210310809613\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Generate API tokens for Docs</em></a><em>.</em></p></li></ul>\n</li>\n</ol><figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"width: 75%;\"><img style=\"aspect-ratio: 1842/1080;\" src=\"https://help.superhuman.com/hc/article_attachments/49824757289613\" alt=\"Generate API token button on the API connections page of Superhuman Docs account settings\" width=\"1842\" height=\"1080\"></figure><ol start=\"7\">\n<li data-list-item-id=\"e9e77bb32fdbb6ddac9267bf85aa086fe\"><p class=\"no-margin\">Open Google Antigravity.</p></li>\n<li data-list-item-id=\"e4faad5f1a153cf68a40bbd4ef49fc921\"><p class=\"no-margin\">Click the horizontal <strong>three-dot menu</strong> in the upper-right corner of the agent panel.</p></li>\n<li data-list-item-id=\"e5d4e50df6ce75deb23bf65843254df09\"><p class=\"no-margin\">Select <strong>MCP Servers</strong>.</p></li>\n</ol><figure class=\"wysiwyg-image wysiwyg-image-resized\" style=\"width: 50%;\"><img style=\"aspect-ratio: 1780/1780;\" src=\"https://help.superhuman.com/hc/article_attachments/47224304244621\" alt=\"Agent panel menu open with MCP Servers option highlighted\" width=\"1780\" height=\"1780\"></figure><ol start=\"10\">\n<li data-list-item-id=\"e8d4edff14996e760d0fd5760cff5ccb0\"><p class=\"no-margin\">Click <strong>Manage MCP Servers</strong>.</p></li>\n<li data-list-item-id=\"e4679f4d9deecdbac07b6d90f5e775e4d\"><p class=\"no-margin\">Click <strong>View raw config</strong>.</p></li>\n<li data-list-item-id=\"e4a3c924271a253882caa0049526e4992\"><p class=\"no-margin\">Enter the following details, replacing <code>Bearer Your-Docs-MCP-Auth-Token</code> with the token you generated and copied earlier:</p></li>\n</ol><pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">{\n  \"mcpServers\": {\n    \"SuperhumanDocs\": {\n      \"serverUrl\": \"https://docs.superhuman.com/apis/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer Your-Docs-MCP-Auth-Token\"\n      }\n    }\n  }\n}</code></pre><ol start=\"13\"><li data-list-item-id=\"eacc317168a563ded06e8d99674c8733b\"><p class=\"no-margin\">Save the file and refresh the MCP server list. The Superhuman Docs MCP should now appear as connected.</p></li></ol><p class=\"no-margin\"> </p><h2 id=\"h_01KN2W9E8KAQSCKQC9XC3530WW\"><strong>FAQs</strong></h2><details><summary><strong>If I already connected to the Coda MCP before launch, do I need to switch to the new Superhuman Docs MCP?</strong></summary><div class=\"collapsible-section-content\"><p class=\"no-margin\">While your existing Coda MCP connections will continue to work for now, we encourage you to connect to the Superhuman Docs MCP as soon as you’re able. We are frequently rolling out new features and improvements to the Docs MCP only, and the Coda MCP will eventually be deprecated.</p></div></details><details><summary><strong>Can I connect Docs MCP to other AI tools not listed in this article?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">You should be able to connect the Superhuman Docs MCP to any AI client that supports creating custom MCP connections. In most cases, you will need to use personal authentication tokens to complete the connection.</p>\n<p class=\"no-margin\">To get a token, open your <a href=\"https://coda.io/account?openDialog=CREATE_API_TOKEN&amp;scopeType=mcp#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">account’s API settings</a>, or scroll to the <strong>API settings</strong> section of your account page and click <strong>Generate API token</strong>. Give your token a memorable name, make sure the restriction type is <strong>MCP</strong>, and choose the type of access. Then click <strong>Generate API token</strong> to create it, and click <strong>Copy token</strong> to copy it to your clipboard.</p>\n</div></details><details><summary><strong>Do I have to be a Doc Maker to connect to the Docs MCP?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">No. Anyone can connect to the Superhuman Docs MCP, but what you can do from there depends on your role in Docs. <a class=\"intercom-content-link\" href=\"https://help.coda.io/hc/en-us/articles/39556004184077-Roles-in-Coda-Doc-Makers-Admins-and-Editors#h_a482e8f612\" target=\"_blank\" rel=\"noopener noreferrer\">Doc Makers</a> on <strong>paid</strong> Superhuman Docs plans have the full Docs MCP experience, including all of the <a href=\"https://coda.io/resources/mcp/tools-and-endpoints\" target=\"_blank\" rel=\"noopener noreferrer\">available tools and endpoints</a>.</p>\n<p class=\"no-margin\">Doc Makers on <strong>free</strong> plans can use a “free taste” of the Docs MCP (30 requests per week, with a max of 60 requests per month). During this “free taste,” you can use all of the tools of the MCP.</p>\n<p class=\"no-margin\">Editors also have access to a “free taste” of the Docs MCP (30 requests per week, with a max of 60 requests per month). As an editor, you can use the MCP to take any <a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210078082701-Roles-in-Superhuman-Docs-Doc-Makers-Admins-and-Editors#h_078ca9fe74\" target=\"_blank\" rel=\"noopener noreferrer\">editor actions</a>, including reading content, adding and deleting tables, adding page content, and modifying existing content.</p>\n</div></details><details><summary><strong>How do I enable the Superhuman Docs connector in Claude, so the rest of my organization can easily connect?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">If you are an admin or owner on a <strong>Team</strong> or <strong>Enterprise</strong> plan in Claude, you need to enable the Superhuman Docs connector for org members before they can connect. To do so, follow these steps:</p>\n<ol>\n<li data-list-item-id=\"e3b5c6c75cb0d8eab11f05a48f143706c\"><p class=\"no-margin\">Go to <a href=\"https://claude.ai/admin-settings/connectors\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>Organization settings → Connectors</strong></a>.</p></li>\n<li data-list-item-id=\"e88179df39a4e21c5b47c865f6afc7721\"><p class=\"no-margin\">Click <strong>Browse connectors</strong> at the bottom of the page.</p></li>\n<li data-list-item-id=\"ef3844cf946f35618a4459483b7af5bac\"><p class=\"no-margin\">Search for the <strong>Superhuman Docs</strong> connector, and click <strong>Add to your team</strong>.</p></li>\n</ol>\n<p class=\"no-margin\">Users in your org can now connect to the Docs MCP by following the steps in <a class=\"intercom-content-link\" href=\"#h_01KN2WCG6N7RNF022XT973CRCD\" target=\"_blank\" rel=\"noopener noreferrer\">Connect Claude Chat &amp; Cowork with Docs MCP</a>. To learn more about enabling and managing connectors in Claude, see <a href=\"https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities#h_b6f69dbd72\" target=\"_blank\" rel=\"noopener noreferrer\">Claude’s documentation on connectors</a>.</p>\n</div></details><details><summary><strong>Why am I getting a 401 error when trying to use my auth token to connect?</strong></summary><div class=\"collapsible-section-content\"><p class=\"no-margin\">You may see this error when the auth token has the incorrect restriction type. To resolve it, <a href=\"https://coda.io/account?openDialog=CREATE_API_TOKEN&amp;scopeType=mcp#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">create a new auth token</a> in your Superhuman Docs account settings, and select <strong>MCP</strong> for the restriction type. Then attempt the connection again with the new token.</p></div></details><details><summary><strong>What auth scopes are used when I connect to the Docs MCP?</strong></summary><div class=\"collapsible-section-content\"><p class=\"no-margin\">When you connect the Docs MCP via OAuth 2 (as with ChatGPT, Claude, and Cursor), the auth scope is automatically set to <strong>read and write</strong>. When you connect via Personal Access Tokens (as described for Google Antigravity), you choose between three scopes: <strong>read only</strong>, <strong>write only</strong>, or <strong>read and write</strong>. To limit the scope to <strong>read only</strong> or <strong>write only</strong>, connect via personal access tokens instead of OAuth 2.</p></div></details><details><summary><strong>How do I submit bugs or feedback for the MCP?</strong></summary><div class=\"collapsible-section-content\"><p class=\"no-margin\">Please submit any bugs or feedback through the <a href=\"https://coda.io/form/Coda-MCP-Beta-Feedback-Form_doDSfpTpgAj\" target=\"_blank\" rel=\"noopener noreferrer\">Docs MCP feedback form</a>. Thank you in advance!</p></div></details><details><summary><strong>Can I connect the Docs MCP to Claude Code using Personal Access Tokens, rather than OAuth?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">Yes. This article describes connecting the MCP to Claude Code via <strong>OAuth</strong>, but you can also connect using <strong>Personal Access Tokens</strong> by following these steps:</p>\n<ol>\n<li data-list-item-id=\"eaf99515ef1a667340a1a77fa00695bc8\">\n<p class=\"no-margin\">Open your <a href=\"https://docs.superhuman.com/account#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">account’s API settings</a>, or scroll to the <strong>API settings</strong> section of your account page, and click <strong>Generate API token</strong>. Give your token a memorable name, choose the type of access, and make sure the <strong>MCP</strong> option is selected. Then click <strong>Generate API token</strong> to create it, and click <strong>Copy token</strong> to copy it to your clipboard.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"e9b2055eb51b455c2346b1c5f9d4d01a4\"><p class=\"no-margin\"><em>Learn more in </em><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210310809613\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Generate API tokens for Docs</em></a><em>.</em></p></li></ul>\n</li>\n<li data-list-item-id=\"ea14bc996cbbd89c87892e42f654d478e\"><p class=\"no-margin\">Next, open a fresh terminal window and paste in the following block, replacing <strong>Your-Docs-Auth-Token</strong> with the auth token you generated and copied in the previous step.</p></li>\n</ol>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">claude mcp add --transport http SuperhumanDocs\nhttps://docs.superhuman.com/apis/mcp --header\n\"Authorization: Bearer Your-Docs-Auth-Token\"</code></pre>\n<ol start=\"3\"><li data-list-item-id=\"e2cdc553684e29d14a5557bc6787de3fd\"><p class=\"no-margin\">Confirm that your MCP was added correctly by pasting the following command into the terminal:</p></li></ol>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">claude mcp list</code></pre>\n<ol start=\"4\"><li data-list-item-id=\"eeb678d0740640a094ed3ffd8b6a98a4f\"><p class=\"no-margin\">Start Claude Code by typing <code>claude .</code> into your terminal and ask it to connect to the Docs MCP:</p></li></ol>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">Connect to the Superhuman Docs MCP</code></pre>\n<p class=\"no-margin\">If successful, you’ll see a success message with Docs MCP tools. You can now start building in Docs using Claude Code!</p>\n</div></details><details><summary><strong>Can I connect to Cursor using personal access tokens, rather than OAuth?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">Yes. This article describes connecting the MCP to Cursor via <strong>OAuth</strong>, but you can also connect using <strong>Personal Access Tokens</strong> by following these steps:</p>\n<ol>\n<li data-list-item-id=\"ecf44100e819a77ee3cfcb192f4cbc78a\"><p class=\"no-margin\">Within your Cursor app, open <strong>Cursor Settings</strong> → <strong>Tools &amp; MCP</strong>.</p></li>\n<li data-list-item-id=\"e5389cf026437fe4d4b451c3e5ece328b\">\n<p class=\"no-margin\">Click <strong>New MCP Server</strong>. This will open a new mcp.json file.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"ec82f7532b0152f7052feec60acd98c17\"><p class=\"no-margin\"><em>Tip: Only enable the MCPs you are currently working with to save context and improve agent accuracy</em></p></li></ul>\n</li>\n<li data-list-item-id=\"edd3aac041716b8db1e641d5b6aba7ee7\">\n<p class=\"no-margin\">Next, open your <a href=\"https://docs.superhuman.com/account#apiSettings\" target=\"_blank\" rel=\"noopener noreferrer\">account’s API settings</a>, or scroll to the <strong>API settings</strong> section of your account page, and click <strong>Generate API token</strong>. Give your token a memorable name, choose the type of access, and make sure the <strong>MCP</strong> option is selected. Then click <strong>Generate API token</strong> to create it, and click <strong>Copy token</strong> to copy it to your clipboard.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"eddd2d5dbef00630b834670c64d014fc6\"><p class=\"no-margin\"><em>Learn more in </em><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210310809613\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Generate API tokens for Docs</em></a><em>.</em></p></li></ul>\n</li>\n<li data-list-item-id=\"e444b524a6dae9af1d092b0a14e060817\"><p class=\"no-margin\">Now, inside your mcp.json file in Cursor, insert the following code, replacing <strong>Your-Docs-Auth-Token</strong> with the auth token you generated and copied in the previous step.</p></li>\n</ol>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto\">{\n  \"mcpServers\": {\n    \"SuperhumanDocs\": {\n      \"url\": \"https://docs.superhuman.com/apis/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer Your-Docs-Auth-Token\"\n      }\n    }\n  }\n}</code></pre>\n<ol start=\"5\"><li data-list-item-id=\"e8467ea583f9c1d28de2d585b3762d674\">\n<p class=\"no-margin\">Once you’ve made the above edits, the file should be saved automatically, and you should now be connected to the Docs MCP. You can verify by checking the tools list (under <strong>Tools &amp; MCP</strong>) or asking Cursor about your tools in Superhuman Docs.</p>\n<ul><li class=\"ck-list-marker-italic\" data-list-item-id=\"ec58593a0f669080d41bcb40fde30bc9a\"><p class=\"no-margin\"><em>Tip: If you don’t see your MCP show up at this stage, restart Cursor.</em></p></li></ul>\n</li></ol>\n</div></details><details><summary><strong>Why do I see a message that my admin has limited MCP access?</strong></summary><div class=\"collapsible-section-content\">\n<p class=\"no-margin\">If your organization is on Superhuman Docs Enterprise, your admin can block the Docs MCP from accessing certain workspaces or folders. When this applies to you, you will see a notice about the restriction towards the top of the authentication window when connecting.</p>\n<p class=\"no-margin\">This means the MCP can’t reach the blocked workspaces or folders, regardless of whether you choose <strong>Full access</strong> or <strong>Limited access</strong> when you connect. Any connections you’ve already made keep working for everything that isn’t blocked.</p>\n<p class=\"no-margin\">If you need the MCP to work with a blocked workspace or folder, contact your org admin. Admins can learn how to manage these restrictions in <a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46702031846029-Manage-AI-and-MCP-controls-for-your-Docs-org\" target=\"_blank\" rel=\"noopener noreferrer\">Manage AI and MCP controls for your Docs org</a>.</p>\n</div></details><p class=\"no-margin\"> </p><hr><h2 id=\"h_01KN2ZDP2RZYZ7ZNBBHTS02KS2\">Related resources</h2><ul>\n<li data-list-item-id=\"e79037309f6ab6b1792dfd0c7f3fed5f4\"><p class=\"no-margin\"><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210102879629\" target=\"_blank\" rel=\"noopener noreferrer\">Using the Superhuman Docs MCP</a></p></li>\n<li data-list-item-id=\"e8c207e25f0e12d5a2e102da3b09df681\"><p class=\"no-margin\"><a class=\"intercom-content-link\" href=\"https://help.superhuman.com/hc/en-us/articles/46210118248205\" target=\"_blank\" rel=\"noopener noreferrer\">Security recommendations for the Docs MCP</a></p></li>\n<li data-list-item-id=\"e76ebf8e0610801fa222ced6b31ffed8d\"><p class=\"no-margin\"><a href=\"https://coda.io/resources/guides/getting_started_with_coda_mcp\" target=\"_blank\" rel=\"noopener noreferrer\">Getting started with Superhuman Docs MCP | Guides</a></p></li>\n</ul>","user_segment_ids":[]}}