Scribe MCP Server

Sandra Kljajic

Updated April 09, 2026 19:44

Available to Enterprise customers on select modules.

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.

Authentication is handled automatically via OAuth 2.0. No API keys or tokens to manage.

Prerequisites

A Scribe account
An MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, Windsurf, custom AI client)

The server is hosted by Scribe. You do not need to install or run anything.

Setup

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.

Claude Code

Run the following command:

claude mcp add --transport http scribe https://mcp.scribe.com/mcp

Or add it manually to ~/.claude.json :

{
  "mcpServers": {
    "scribe": {
      "url": "https://mcp.scribe.com/mcp"
    }
  }
}

Claude Desktop

Open Claude Desktop → Customize (sidebar) → Connectors → Settings → Developer Settings → Edit Config
Open the config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following to the file:

{
  "mcpServers": {
    "scribe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.scribe.com/mcp"]
    }
  }
}

Cursor

Open Cursor Settings → MCP Servers → Add Server, or add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "scribe": {
      "url": "https://mcp.scribe.com/mcp"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "scribe": {
      "serverUrl": "https://mcp.scribe.com/mcp"
    }
  }
}

Note: Windsurf uses serverUrl instead of url.

Copilot Studio

Open your agent in Copilot Studio and go to the Tools page.
Select Add a tool → New tool → Model Context Protocol. The MCP onboarding wizard appears.
Fill in the following fields:
- Server name: e.g. Scribe
- Server description: A brief description of Scribe
- Server URL: https://mcp.scribe.com/mcp
Under authentication, select OAuth 2.0 (Scribe uses OAuth on first connection to authorize access).
Select Create to register the server.
On the Add tool dialog, select Create a new connection and then Add to agent to finish.

On first connection, your browser will open so you can sign in to Scribe and authorize access.

VS Code (GitHub Copilot)

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → "Preferences: Open User Settings (JSON)" and add:

{
  "mcp": {
    "servers": {
      "scribe": {
        "type": "http",
        "url": "https://mcp.scribe.com/mcp"
      }
    }
  }
}

Alternatively, create a .vscode/mcp.json file in your workspace root for project-scoped configuration.

What you can do

Once connected, your AI assistant can access your Scribe workspace through natural language. Here are some examples of what you can ask.

Documents (with Capture)

Search your Scribe documents by keyword, browse by team or date, and retrieve step-by-step guides with screenshots.

"Find our onboarding guide"
"Show me all SOPs updated this month"
"What documents does the Engineering team have?"
"Get the screenshots for the password reset process"

Workflows (with Optimize)

Explore your organization's business processes discovered by Scribe. Navigate the hierarchy from value chains down to individual tasks, and review execution history.

"What business processes do we have?"
"Show me the workflow hierarchy for Sales Operations"
"How long does the lead qualification process take?"
"What apps are used in the invoicing workflow?"

Insights (with Optimize)

Surface AI-detected friction points and optimization opportunities across your workflows, with actionable recommendations.

"Where are the bottlenecks in our workflows?"
"Show me high-severity improvement opportunities"
"What are the recommendations for reducing onboarding time?"
"Which workflows have the most optimization potential?"

Cross-source search

Search across documents, workflows, and insights simultaneously when you're not sure where the answer lives.

"How do we handle QA?"
"What do we know about the returns process?"

Authentication

The Scribe MCP server uses OAuth 2.0. When you first connect from any AI client:

Your browser opens automatically
You sign in to your Scribe account
You authorize the AI client to access your workspace

HC MCP.png

You're returned to your AI client, ready to go

Your session persists until you revoke access or sign out. Tokens refresh automatically — you won't need to re-authenticate during normal use.

Permissions: 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.

Troubleshooting

Connection failed or "401 Unauthorized" Make sure the server URL is exactly https://mcp.scribe.com/mcp. Verify that your AI client supports remote MCP servers with OAuth.

Authorized but tools aren't working Restart your AI client after completing the authorization flow. Some clients require a restart to pick up the new connection.

Screenshots are broken or not loading Screenshot URLs expire 15 minutes after retrieval. Ask your AI assistant to fetch the document again for fresh URLs.

Missing documents or workflows The MCP server shows the same data you can access in the Scribe web app. Check your team membership and permission settings in Scribe.

Rate limit exceeded The server limits the number of requests per user. Wait a moment and try again.

Windsurf: server not connecting Windsurf uses serverUrl instead of url in its configuration. Double-check the key name in your config file.

Admin Setting

Organization admins can control whether the MCP server is available for their workspace. Navigate to Settings → Developer Access and toggle Enable MCP Server Connection 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.

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.