> For the complete documentation index, see [llms.txt](https://brivvy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brivvy.gitbook.io/docs/mcp-server/mcp-server.md).

# MCP Server

Learn how to connect Sofy's MCP Sever with Claude's web-based client, desktop client, and Claude Code.

The Sofy Model Context Protocol (MCP) server lets AI assistants like Claude access your brand voice, content templates, audience definitions, and glossary terms directly. This means you can generate on-brand content right inside your AI tools.

When connected, any MCP-compatible AI application can use Sofy's brand intelligence to create content that matches your voice and style guidelines. The server provides secure, authenticated access to your workspace through a standardized protocol.

Sofy's MCP server is hosted and maintained by us, following the authenticated remote [MCP specification](https://modelcontextprotocol.io/specification/2025-03-26). The available tools let you retrieve brand voice settings, access content templates, query audience definitions, and look up glossary terms. This ensures every piece of AI-generated content aligns with your brand standards.

### General

The Sofy MCP server supports the Streamable HTTP transport. Authentication uses OAuth 2.1 with dynamic client registration at:

* `https://mcp.brivvy.io`

{% hint style="warning" %}
SSE transport (`/sse`) is not supported.
{% endhint %}

See below for setup instructions by platform.

### Available tools

The Sofy MCP server provides:

* **Brand Voice Access**: Get your tone settings and style guidelines
* **Template Library**: Access all templates with their structure and variables
* **Audience Profiles**: Query audience definitions to tailor your content
* **Glossary Lookup**: Search approved terms and style preferences
* **Content Generation**: Create on-brand content using templates and brand voice

### Supported platforms

The Sofy MCP Server works with AI platforms that support the Model Context Protocol standard. Currently we have optimized around the following platforms:

* Claude
* ChatGPT
* Cursor

Note that each platform implements MCP differently. Setup requirements and connection methods vary by platform.

### Security and Authentication

The Sofy MCP Server uses OAuth authentication to connect with the Sofy platform. Authentication tokens are stored locally on the device running the AI platform.

No brand data is transmitted to AI platforms directly. The AI platform requests data from the MCP Server as needed during content generation. All requests require valid authentication.

### FAQs

<details>

<summary><strong>I'm seeing an internal server error when connecting. What should I do?</strong></summary>

Clear your saved authentication data by running this in Terminal: `rm -rf ~/.mcp-auth` and try reconnecting. You may also need to update to a newer version of Node.js if prompted.

</details>

<details>

<summary><strong>I'm using WSL on Windows and encountering errors</strong></summary>

Try this alternative configuration:

{% code overflow="wrap" %}

```json
{
  "mcpServers": {
    "sofy": {
      "command": "wsl",
      "args": ["npx", "-y", "mcp-remote", "https://mcp.sofy.io"]
    }
  }
}
```

{% endcode %}

</details>

<details>

<summary><strong>Does the MCP server support Streamable HTTP?</strong></summary>

Yes, the streamable HTTP transport is available at `https://mcp.sofy.io`

</details>

<details>

<summary><strong>Can I use my own API keys instead of OAuth?</strong></summary>

Yes. The Sofy MCP server accepts API keys in the `Authorization: Bearer <your-token>` header. This lets you skip the interactive authentication flow, which is useful for automation, read-only access, or integrating with existing OAuth applications.

</details>

<details>

<summary><strong>Which workspace will the MCP server access?</strong></summary>

The server accesses the workspace tied to your authentication credentials. If you have multiple workspaces, specify which one to use during OAuth or in your Sofy account settings.

</details>

<details>

<summary><strong>How often is the data synchronized?</strong></summary>

Data is fetched in real-time when requested. You always work with the most current information from your Sofy workspace.

</details>

<details>

<summary><strong>Can I limit what data the MCP server can access?</strong></summary>

Yes. When generating an API key in Sofy, you can set permissions like read-only access or specific workspace restrictions.

</details>