# Connect Claude Code

**Auth:** bearer token. **Prereq:** familiar deployed over HTTPS (see [deployment](../deployment.md)).

Claude Code speaks HTTP MCP with custom headers directly. Add the server:

```bash
claude mcp add --transport http familiar https://familiar.yourdomain.tld/mcp \
  --header "Authorization: Bearer <your-token>"
```

- `<your-token>` is your `FAMILIAR_HTTP_TOKEN`.
- Use the full URL including the `FAMILIAR_HTTP_PATH` (default `/mcp`).

Check it:

```bash
claude mcp list          # familiar should show as connected
```

Then ask Claude Code to call `ping`, or "what's Tritanium worth in Jita?".

To scope it to the current project instead of your user config, add `--scope project` (writes a `.mcp.json` in the repo). Remove it with `claude mcp remove familiar`.

## Troubleshooting

- **401** — the token is wrong or missing; re-run `claude mcp add` with the correct `Authorization` header.
- **Hangs / times out** — your reverse proxy is likely buffering; set `proxy_buffering off;` and a long read timeout (see [deployment](../deployment.md#tls-reverse-proxy)).