Files
familiar/doc/clients/mistral.md
T
Latte df9e06a3e7
CI / lint (pull_request) Successful in 55s
docker / lint (pull_request) Successful in 56s
CI / test (pull_request) Successful in 1m6s
docker / test (pull_request) Successful in 1m4s
CI / publish (pull_request) Has been skipped
docker / docker (pull_request) Failing after 1m11s
docs: deployment guide + per-client setup + connect matrix
- doc/deployment.md: run familiar as a remote MCP server — secure defaults,
  bearer vs OAuth modes, the full env-var reference, one-time login / token-store
  provisioning, the published images, docker compose, and TLS reverse-proxy
  blocks for nginx (proxy_buffering off + long read timeout), Caddy, and Traefik.
- doc/clients/: one page per client with exact working steps — Claude Code,
  VS Code (.vscode/mcp.json with a masked token input, and the workspace
  .mcp.json header gotcha), Mistral Le Chat, Claude Desktop + Cowork (mcp-remote
  bridge, per-OS config paths), and Claude web (oauth mode + external IdP, with
  "use Desktop + bearer" as the simpler alternative). Plus a clients/ index.
- README: a "Connect a client" matrix (client -> auth -> guide) and a compact
  "Deploy with Docker" section linking to doc/deployment.md; oauth mode noted.
- doc/README.md index: rows for Deployment and Client setup.
- doc/getting-started.md: pointer from the HTTPS quickstart to the full docs.
- CLAUDE.md: FAMILIAR_AUTH_MODE / FAMILIAR_OAUTH_* / FAMILIAR_ALLOW_INSECURE_BIND
  and /healthz in the transport note; the split ci.yml / docker.yml workflows.

Deployment docs live under the existing doc/ tree (the repo uses doc/, not a
separate docs/) to keep a single documentation directory.
2026-07-04 19:26:33 +02:00

891 B

Connect Mistral Le Chat

Auth: bearer token. Prereq: familiar deployed over HTTPS (see deployment).

Mistral's chat.mistral.ai supports remote MCP servers with a bearer token natively.

  1. Open Intelligence → Connectors → Add custom connector.
  2. URL: https://familiar.yourdomain.tld/mcp (include the FAMILIAR_HTTP_PATH, default /mcp).
  3. Authentication: choose Bearer Token and paste your FAMILIAR_HTTP_TOKEN.
  4. Save, then enable the connector in a conversation.

Ask Le Chat to call ping, or "compare Plex prices across trade hubs".

Troubleshooting

  • 401 / connector won't enable — wrong or missing token; re-check the Bearer Token value.
  • Timeouts — reverse-proxy buffering; set proxy_buffering off; and a long read timeout (see deployment).