Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and data sources. clarife exposes an MCP endpoint that gives AI agents full access to your workspace.

​
MCP Endpoint

https://my.clarife.app/api/v1/mcp
Uses HTTP Streamable transport (POST). Authentication is the same Bearer token used for the REST API.

​
Setup

Edit your claude_desktop_config.json:
{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_your_key_here"
      }
    }
  }
}
Restart Claude Desktop to load the new server.

​
Team Workspace

To target a specific workspace, add the X-Workspace-Id header: 
{
  "mcpServers": {
    "clarife": {
      "url": "https://my.clarife.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer clrf_your_key_here",
        "X-Workspace-Id": "a1b2c3d4-5678-90ab-cdef-1234567890ab"
      }
    }
  }
}

​
Available Tools

The MCP server exposes 28 tools that mirror the REST API. Each tool requires the same scopes as its REST counterpart.
ToolScopeDescription
list_documentsdocuments:readList documents with pagination
get_documentdocuments:readGet a document with content
create_documentdocuments:writeCreate a new document
update_documentdocuments:writeUpdate document fields
delete_documentdocuments:writeSoft-delete a document
list_projectsprojects:readList projects
get_projectprojects:readGet a project with documents
create_projectprojects:writeCreate a project
update_projectprojects:writeUpdate a project
delete_projectprojects:writeDelete a project
move_projectprojects:writeMove project to a folder
list_foldersprojects:readList folders
create_folderprojects:writeCreate a folder
update_folderprojects:writeUpdate a folder
delete_folderprojects:writeDelete a folder
list_sharesshares:readList share links
get_shareshares:readGet share with view stats
create_shareshares:writeCreate a share link
update_shareshares:writeUpdate a share link
delete_shareshares:writeDelete a share link
presign_mediamedia:writeGet a presigned upload URL
confirm_mediamedia:writeConfirm a media upload
get_workspaceworkspace:readGet workspace details
list_workspace_membersworkspace:readList workspace members
list_brandingsbrandings:readList branding configurations
get_brandingbrandings:readGet a branding configuration

​
Example Prompts

Once connected, you can ask your AI assistant things like:
  • “List all my clarife documents”
  • “Create a new document called ‘API Integration Guide’ in the Product Docs project”
  • “Share the onboarding tutorial with a password and a 30-day expiry”
  • “Export the setup guide as PDF and give me the download link”
  • “Show me the members of my workspace”
Grant your MCP API key only the scopes the AI assistant needs. For read-only exploration, documents:read and projects:read are enough.