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

# VS Code

> Add the Quotable MCP server to VS Code with an mcp.json that prompts for your API key once and stores it masked.

VS Code's chat connects to remote MCP servers over HTTP with custom headers. Its `mcp.json` format can prompt for your API key and store it securely, so the key never sits in the file.

## Before you start

* A Quotable API key from **Settings → API keys**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md).
* VS Code with chat enabled.

## Add the server

> [tab] This workspace
>
> Create `.vscode/mcp.json` in your project:
>
> ```json .vscode/mcp.json theme={"system"}
> {
>   "inputs": [
>     {
>       "type": "promptString",
>       "id": "quotable-api-key",
>       "description": "Quotable API key (quotable_live_…)",
>       "password": true
>     }
>   ],
>   "servers": {
>     "quotable": {
>       "type": "http",
>       "url": "https://app.usequotable.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer ${input:quotable-api-key}"
>       }
>     }
>   }
> }
> ```
>
> This file contains no secret, so you can commit it. Each teammate enters their own key.

> [tab] All workspaces
>
> Run **MCP: Open User Configuration** from the Command Palette and add the same `inputs` and `servers` entries to your user `mcp.json`.

The first time the server starts, VS Code asks you to trust it, then prompts for the key and masks what you type.

## Check the connection

Run **MCP: List Servers** from the Command Palette and select `quotable` to start it, see its status or show its output. In the chat view, select **Configure Tools** to see the Quotable tools and turn individual tools on or off. Turn off `run_agent` if chat shouldn't start agent runs.

If the server fails to start with a `401`, the key you entered is wrong, expired or revoked. Check the server's output for the exact message and see [Troubleshooting](https://docs.usequotable.com/mcp-server/troubleshooting.md).

## Try it

Open chat in agent mode and ask:

```text theme={"system"}
Using Quotable, list the active prompts for my main brand and group them by topic.
```

Chat picks the Quotable tools it needs. VS Code asks for confirmation before it runs a tool.

> [!NOTE]
>
> VS Code also reads portable MCP configuration files, `.mcp.json` at the workspace root and `~/.copilot/mcp-config.json`, which use a top-level `mcpServers` object. This guide uses `mcp.json` with `servers` because it supports the masked key prompt.

## Next steps

> [card] [Example prompts](https://docs.usequotable.com/mcp-server/example-prompts.md)
>
> Ready-to-use questions for your workspace.

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Turn Quotable data into content briefs in your repo.

> [card] [Tools reference](https://docs.usequotable.com/mcp-server/tools.md)
>
> Inputs and outputs for each tool.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.