{"article":{"id":35221245251485,"url":"https://scribehow1125.zendesk.com/api/v2/help_center/en-us/articles/35221245251485.json","html_url":"https://support.scribehow.com/hc/en-us/articles/35221245251485-Scribe-MCP-Server","author_id":6564652069533,"comments_disabled":true,"draft":false,"promoted":false,"position":13,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":34344915050141,"created_at":"2026-04-08T13:18:55Z","updated_at":"2026-07-03T15:35:06Z","name":"Scribe MCP Server","title":"Scribe MCP Server","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-07-03T15:35:06Z","user_segment_id":null,"permission_group_id":5361977926941,"content_tag_ids":[],"label_names":[],"body":"<p><em>Available to Enterprise customers on select modules.</em></p><p>The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Scribe data in a simple and secure way. Search documents, explore business workflows, and surface optimization insights — all from your AI assistant.</p><p>Authentication is handled automatically via OAuth 2.0. No API keys or tokens to manage.</p><h2 id=\"h_01KNPHJ64WE7X6NGQA8HK1F47M\">Prerequisites</h2><ul>\n<li data-list-item-id=\"e4519f324e23205cd5e77935d0639a2c8\">A <a href=\"https://scribe.com/\">Scribe</a> account</li>\n<li data-list-item-id=\"e2a65813ced408c002301204b0822a528\">An MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, Windsurf, custom AI client)</li>\n</ul><p>The server is hosted by Scribe. You do not need to install or run anything.</p><h2 id=\"h_01KNPHJ64ZT7HJK896S0K7YGE1\">Setup</h2><p>Add the Scribe MCP server to your AI client's configuration. On first connection, your browser will open so you can sign in to Scribe and authorize access.</p><h3 id=\"h_01KTKKMXK51KC9N4WQM4G4EWJR\">ChatGPT</h3><p>Open ChatGPT → Developer Tools → Add MCP Server.</p><p>Fill in the following fields:<br><strong>Server URL:</strong> <a href=\"https://mcp.scribe.com/mcp\" target=\"_blank\" rel=\"noopener noreferrer\">https://mcp.scribe.com/mcp</a><br><strong>Authentication:</strong> OAuth</p><p>On the first connection, your browser will open so you can sign in to Scribe and authorize access.</p><p><strong>Note: </strong>MCP support in ChatGPT requires a ChatGPT Business, Enterprise, or Edu plan with access to Developer Tools.</p><h3 id=\"h_01KNPHJ65055T56EJ3J0Z7K87H\">Claude Code</h3><p>Run the following command:</p><pre style=\"background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 14px; line-height: 1.6;\">claude mcp <span style=\"color: #e5534b;\">add</span> --transport http scribe https://mcp.scribe.com/mcp\n</pre><p> </p><p>Or add it manually to <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">~/.claude.json</code> :</p><pre><code class=\"language-json\">{\n  \"mcpServers\": {\n    \"scribe\": {\n      \"url\": \"https://mcp.scribe.com/mcp\"\n    }\n  }\n}</code></pre><h3 id=\"h_01KNPJN4SCBWVP1BPHXF5RG66A\"> </h3><h3 id=\"h_01KNPJNQMVCFJ6BY7XX4BK63G8\">Claude Desktop</h3><ol>\n<li data-list-item-id=\"e9271a52433f203fa995c2c2a27165bd0\">Open <strong>Claude Desktop → Customize (sidebar) → Connectors → Settings → Developer Settings → Edit Config</strong>\n</li>\n<li data-list-item-id=\"e765e34c80bf85da4c514b421b91b3e63\">\n<p>Open the config file:</p>\n<ul>\n<li data-list-item-id=\"e420adf28031d04104d404c944e37b99d\">macOS: <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">~/Library/Application Support/Claude/claude_desktop_config.json</code>\n</li>\n<li data-list-item-id=\"e57e6fb0d716123112adf28e3777c2ed3\">Windows: <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">%APPDATA%\\Claude\\claude_desktop_config.json</code>\n</li>\n</ul>\n<p> </p>\n</li>\n<li data-list-item-id=\"ec6841c7c18864b8e9e5cb02419a8e5ef\">Add the following to the file:</li>\n</ol><pre style=\"background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 14px; line-height: 1.6;\">{\n  <span style=\"color: #8b1a6b;\">\"mcpServers\"</span>: {\n    <span style=\"color: #8b1a6b;\">\"scribe\"</span>: {\n      <span style=\"color: #8b1a6b;\">\"command\"</span>: <span style=\"color: #6b7c00;\">\"npx\"</span>,\n      <span style=\"color: #8b1a6b;\">\"args\"</span>: [<span style=\"color: #6b7c00;\">\"-y\"</span>, <span style=\"color: #6b7c00;\">\"mcp-remote\"</span>, <span style=\"color: #6b7c00;\">\"https://mcp.scribe.com/mcp\"</span>]\n    }\n  }\n}</pre><p> </p><h3 id=\"h_01KNPJW9APS33HGE3YEGV5YZ5F\">Cursor</h3><p>Open Cursor Settings → MCP Servers → Add Server, or add to <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">.cursor/mcp.json</code> in your project root:</p><p> </p><pre style=\"background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 14px; line-height: 1.6;\">{\n  <span style=\"color: #8b1a6b;\">\"mcpServers\"</span>: {\n    <span style=\"color: #8b1a6b;\">\"scribe\"</span>: {\n      <span style=\"color: #8b1a6b;\">\"url\"</span>: <span style=\"color: #6b7c00;\">\"https://mcp.scribe.com/mcp\"</span>\n    }\n  }\n}</pre><p> </p><h3 id=\"h_01KNPK1AZGGZ6KQN49HDS4DWX9\">Windsurf</h3><p>Edit <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">~/.codeium/windsurf/mcp_config.json</code> :</p><p> </p><pre style=\"background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 14px; line-height: 1.6;\">{\n  <span style=\"color: #8b1a6b;\">\"mcpServers\"</span>: {\n    <span style=\"color: #8b1a6b;\">\"scribe\"</span>: {\n      <span style=\"color: #8b1a6b;\">\"serverUrl\"</span>: <span style=\"color: #6b7c00;\">\"https://mcp.scribe.com/mcp\"</span>\n    }\n  }\n}</pre><p><strong>Note:</strong> Windsurf uses <strong>serverUrl</strong> instead of <strong>url</strong>.</p><p> </p><h2 id=\"h_01KNPKAHJ0Y439NA39MKY2ZYMH\"><strong>Copilot Studio</strong></h2><ol>\n<li data-list-item-id=\"e5342f0a2dde2622960190f858848a979\">Open your agent in Copilot Studio and go to the <strong>Tools</strong> page.</li>\n<li data-list-item-id=\"e1715a66515e9e3119cee5cc2d9b0f48e\">Select <strong>Add a tool</strong> → <strong>New tool</strong> → <strong>Model Context Protocol</strong>. The MCP onboarding wizard appears.</li>\n<li data-list-item-id=\"e5f05c3b3a034025034c69f6042fb89d7\">Fill in the following fields:<ul>\n<li data-list-item-id=\"eb5014891d2e71b5184a19bec1f878fd2\">\n<strong>Server name:</strong> e.g. <code>Scribe</code>\n</li>\n<li data-list-item-id=\"e48f3af04be6016427253369a1f034549\">\n<strong>Server description:</strong> A brief description of Scribe</li>\n<li data-list-item-id=\"e0b8212f5fd98aa2dc63dd3ed9c58bf0d\">\n<strong>Server URL:</strong> <code>https://mcp.scribe.com/mcp</code>\n</li>\n</ul>\n</li>\n<li data-list-item-id=\"e80c9178d3d0693a0b9d9dde2afc30d80\">Under authentication, select <strong>OAuth 2.0</strong> (Scribe uses OAuth on first connection to authorize access).</li>\n<li data-list-item-id=\"edd8a190c38e42946985f4a575315d692\">Select <strong>Create</strong> to register the server.</li>\n<li data-list-item-id=\"ef03f3060fa94d87443b34d36ff7b8941\">On the <strong>Add tool</strong> dialog, select <strong>Create a new connection</strong> and then <strong>Add to agent</strong> to finish.</li>\n</ol><blockquote><p>On first connection, your browser will open so you can sign in to Scribe and authorize access.</p></blockquote><h3 id=\"h_01KNPKAHJ53MGW5G5V9N1PF0BV\"> </h3><h3 id=\"h_01KNPKAQ1RVJFFZ5WXRBG6N5P3\">VS Code (GitHub Copilot)</h3><p>Open the Command Palette (<code>Cmd+Shift+P</code> / <code>Ctrl+Shift+P</code>) → \"Preferences: Open User Settings (JSON)\" and add:</p><pre style=\"background: #f5f5f5; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 14px; line-height: 1.6;\">{\n  <span style=\"color: #8b1a6b;\">\"mcp\"</span>: {\n    <span style=\"color: #8b1a6b;\">\"servers\"</span>: {\n      <span style=\"color: #8b1a6b;\">\"scribe\"</span>: {\n        <span style=\"color: #8b1a6b;\">\"type\"</span>: <span style=\"color: #6b7c00;\">\"http\"</span>,\n        <span style=\"color: #8b1a6b;\">\"url\"</span>: <span style=\"color: #6b7c00;\">\"https://mcp.scribe.com/mcp\"</span>\n      }\n    }\n  }\n}</pre><p> </p><p>Alternatively, create a <code style=\"background-color: #f5f5f5; border-radius: 4px; color: #e5534b; font-family: monospace; font-size: 14px; padding: 2px 6px;\">.vscode/mcp.json</code> file in your workspace root for project-scoped configuration.</p><p> </p><h2 id=\"h_01KNPKEWX4YV46XPGSPCA5NYEW\">What you can do</h2><p>Once connected, your AI assistant can access your Scribe workspace through natural language. Here are some examples of what you can ask.</p><h3 id=\"h_01KNPKEWX4JV1JQADRXY45JAVX\">Documents (with Capture)</h3><p>Search your Scribe documents by keyword, browse by team or date, and retrieve step-by-step guides with screenshots.</p><ul>\n<li data-list-item-id=\"eb6423c79b91fec868a93c53ac86b2d7d\">\"Find our onboarding guide\"</li>\n<li data-list-item-id=\"e503a048cd57703cbd6af4f34a991d247\">\"Show me all SOPs updated this month\"</li>\n<li data-list-item-id=\"ed93d6e2ebd4ae24ea592be9bceca65dc\">\"What documents does the Engineering team have?\"</li>\n<li data-list-item-id=\"e32248720cc6dee06af804ae179482acd\">\"Get the screenshots for the password reset process\"</li>\n</ul><h3 id=\"h_01KNPKEWX5CFWZ8XA7E0BG9N81\">Workflows (with Optimize)</h3><p>Explore your organization's business processes discovered by Scribe. Navigate the hierarchy from value chains down to individual tasks, and review execution history.</p><ul>\n<li data-list-item-id=\"e3b5ce84ef9d6920b2f9468289a53a6ac\">\"What business processes do we have?\"</li>\n<li data-list-item-id=\"ebf77d4fa5b83e361af3d266d38ccabb0\">\"Show me the workflow hierarchy for Sales Operations\"</li>\n<li data-list-item-id=\"ea3da3a993df6add363445105b3d27151\">\"How long does the lead qualification process take?\"</li>\n<li data-list-item-id=\"ed8e376de1a627fc9e06d55a57be9a20f\">\"What apps are used in the invoicing workflow?\"</li>\n</ul><h3 id=\"h_01KNPKEWX6SAEGB2NV5ZE0XYY3\">Insights (with Optimize)</h3><p>Surface AI-detected friction points and optimization opportunities across your workflows, with actionable recommendations.</p><ul>\n<li data-list-item-id=\"eeddb169dea303d0b32ec8dfbe04adde0\">\"Where are the bottlenecks in our workflows?\"</li>\n<li data-list-item-id=\"e52c96d4725e0cc1decd23e46765a7a72\">\"Show me high-severity improvement opportunities\"</li>\n<li data-list-item-id=\"eec124fb8a3d07edc3ae2c478947d6c59\">\"What are the recommendations for reducing onboarding time?\"</li>\n<li data-list-item-id=\"e6e51ac9bc0c105f94a3a1f168b079ebf\">\"Which workflows have the most optimization potential?\"</li>\n</ul><h3 id=\"h_01KNPKEWX7RKQ1CW2FJ7ZAMRD0\">Cross-source search</h3><p>Search across documents, workflows, and insights simultaneously when you're not sure where the answer lives.</p><ul>\n<li data-list-item-id=\"e3563a72fbbb5a773b7a3cb6484a0f364\">\"How do we handle QA?\"</li>\n<li data-list-item-id=\"e2f70c4a673a31cd23b28ea726b48744e\">\"What do we know about the returns process?\"</li>\n</ul><h2 id=\"h_01KNPKEWX75YBKDW1CXYQM2HND\">Authentication</h2><p>The Scribe MCP server uses OAuth 2.0. When you first connect from any AI client:</p><ol>\n<li data-list-item-id=\"eef5d288b2f39033a1e323718e3ac8eb0\">Your browser opens automatically</li>\n<li data-list-item-id=\"edd7ac5050b6e3b78edb5e1c9a170ab0a\">You sign in to your Scribe account</li>\n<li data-list-item-id=\"ef6a15fa25bc6fabd9f390a0c8c2bca02\">\n<p>You authorize the AI client to access your workspace</p>\n<figure class=\"wysiwyg-image wysiwyg-image-resized wysiwyg-image-block-align-left\" style=\"width: 60.04%;\"><img style=\"aspect-ratio: 814/854;\" src=\"https://support.scribehow.com/hc/article_attachments/37345913315613\" width=\"814\" height=\"854\"></figure>\n</li>\n<li data-list-item-id=\"ec16f891591fa35583aa15d00c711cd74\">You're returned to your AI client, ready to go</li>\n</ol><p>Your session persists until you revoke access or sign out. Tokens refresh automatically — you won't need to re-authenticate during normal use.</p><p><strong>Permissions:</strong> The MCP server respects your existing Scribe permissions. You can access the same documents, workflows, and insights that are visible to you in the Scribe web app.</p><h2 id=\"h_01KNPKW4GEGHQ98R1J8THMYA9K\">Troubleshooting</h2><p><strong>Connection failed or \"401 Unauthorized\"</strong> Make sure the server URL is exactly <code>https://mcp.scribe.com/mcp</code>. Verify that your AI client supports remote MCP servers with OAuth.</p><p><strong>Authorized but tools aren't working</strong> Restart your AI client after completing the authorization flow. Some clients require a restart to pick up the new connection.</p><p><strong>Screenshots are broken or not loading</strong> Screenshot URLs expire 15 minutes after retrieval. Ask your AI assistant to fetch the document again for fresh URLs.</p><p><strong>Missing documents or workflows</strong> The MCP server shows the same data you can access in the Scribe web app. Check your team membership and permission settings in Scribe.</p><p><strong>Rate limit exceeded</strong> The server limits the number of requests per user. Wait a moment and try again.</p><p><strong>Windsurf: server not connecting</strong> Windsurf uses <code>serverUrl</code> instead of <code>url</code> in its configuration. Double-check the key name in your config file.</p><h2 id=\"h_01KNPKW4GHH6BWDP50W0BP8BBJ\">Admin Setting</h2><p>Organization admins can control whether the MCP server is available for their workspace. Navigate to <strong>Settings</strong> → <strong>Developer Access</strong> and toggle <strong>Enable MCP Server Connection</strong> on or off. When disabled, no users in the organization will be able to authenticate or connect to the MCP server from any AI client. Existing sessions will be revoked.</p><p>This setting is enabled by default. If you're a user and can't connect, check with your organization admin to confirm MCP access hasn't been turned off.</p>"}}