> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brivvy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect the Brivvy MCP Server with Claude Code to access brand voice and templates from the command line.

Claude Code supports remote Model Context Protocol (MCP) servers over the Streamable HTTP transport with built-in OAuth authentication. You can add Brivvy with a single command in your terminal. Once connected, Claude Code can call Brivvy tools to retrieve brand voice rules, glossary terms and template instructions without leaving your shell. This works well for generating on-brand README files, release notes, commit messages and user-facing copy while you code.

## Before you start

* Claude Code installed and signed in to your Anthropic account.
* A Brivvy account.
* Terminal access with permission to run `claude` commands.

## Steps

1. **Add Brivvy as a remote MCP server.** Open your terminal and run the following to register the server:

```bash theme={null}
   claude mcp add --transport http brivvy https://mcp.brivvy.io
```

By default, Claude Code uses local scope, so the server is only available in the current project. To make Brivvy available across all your projects, add the `--scope user` flag:

```bash theme={null}
   claude mcp add --scope user --transport http brivvy https://mcp.brivvy.io
```

2. **Start a new Claude Code session.** Run `claude` in your terminal. Configuration changes take effect when a new session starts, so any existing sessions will not see Brivvy until you restart them.
3. **Open the MCP management menu.** Inside Claude Code, type `/mcp` to list configured servers. You should see `brivvy` with a "needs authentication" status.
4. **Authenticate with Brivvy.** Select `brivvy` from the menu, then select **Authenticate**. Your browser will open an authorization page where you can sign in to Brivvy and approve access. After you authorize, Claude Code stores the OAuth credentials locally.
5. **Confirm the connection.** Back in the terminal, you should see "Authentication successful". Run `/mcp` again and confirm Brivvy shows a connected status. Expand the entry to see the available tools: `list_voices`, `get_voice`, `list_templates` and `get_template`.

## How to know it worked

Send a prompt that requires brand voice context, for example: "Using Brivvy, get the brand voice rules and write a two-sentence release note for the latest version." Claude Code will call the appropriate Brivvy tool and return a response shaped by your brand voice rules rather than a generic output.