# Welcome to FullContact Support

Search our Knowledge Base or Contact Support.

# Quickstart

On this page

- Claude Desktop
- Claude Code
- Gemini CLI
- Cursor
- VS Code
- ChatGPT (Custom Connector)
- Verify the connection
- Next steps

This guide walks you through connecting the FullContact MCP Server to the most common AI clients. The setup is the same in spirit across every client: point the client at the MCP Server endpoint and supply your FullContact API key as a Bearer token.

If you don't yet have a key, generate one at [docs.fullcontact.com/docs/generate-an-api-key](https://docs.fullcontact.com/docs/generate-an-api-key) before continuing.

> 📘 **All clients require an API key**  
> The MCP Server reuses your existing FullContact API key for authentication. There is no separate MCP credential to provision. Every example below assumes you have set the environment variable `FULLCONTACT_API_KEY` to your key, and we recommend using a secrets manager or `.env` rather than hard-coding the value.

The hosted MCP Server endpoint is:

```
https://api.fullcontact.com/v3/mcp
```

* * *

## Claude Desktop

Claude Desktop loads MCP servers from `claude_desktop_config.json`. The server runs as a subprocess of the desktop app, so the config has to give it everything it needs to launch on its own — no shell environment, no PATH inheritance.

> 📘 **Before you start**  
> You need **Node.js** installed locally so that `npx` can fetch the `mcp-remote` bridge. Install Node from [nodejs.org](https://nodejs.org/) or via Homebrew (`brew install node`) before continuing. Confirm with `which npx` in a terminal — you'll need that absolute path in step 2.

**1\. Open the config file.**

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`  
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

If the file doesn't exist, create it with `{}` as the contents. If it does exist, **merge** the `mcpServers` block below into it — don't overwrite any existing keys (e.g. `preferences`).

### **macOS Finder tip**

The `Library` folder is hidden by default. In Finder, hold **Option** while clicking the **Go** menu — `Library` will appear in the list. Or press **⌘⇧G** and paste `~/Library/Application Support/Claude`.

**2\. Add the FullContact MCP Server entry.**

```json
{
  "mcpServers": {
    "fullcontact": {
      "command": "/opt/homebrew/bin/npx",
      "args": [\
        "-y",\
        "mcp-remote",\
        "https://api.fullcontact.com/v3/mcp",\
        "--header",\
        "Authorization: Bearer <your-fullcontact-api-key>"\
      ]
    }
  }
}
```

> ⚠️ **Two gotchas worth calling out**  
> - **Use the absolute path to `npx`.** Claude Desktop is a GUI app and does not inherit your shell `PATH`, so `