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

# Démarrage rapide

> Votre premier appel authentifié à l'API REST Locus et au serveur MCP.

Il vous faut une clé API Locus — un jeton bearer de la forme
`lsk_<slug>_<random>`. Voir [Authentification](/fr/authentication).

<Note>
  URL de base utilisée ici : `https://core.locusmedical.fr`. Remplacez-la par
  l'URL de votre déploiement si elle diffère.
</Note>

## 1. Appeler l'API REST

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://core.locusmedical.fr/v1/search \
    -H "Authorization: Bearer $LOCUS_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"query": "antibioprophylaxie chirurgie colorectale", "limit": 5}'
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.post(
      "https://core.locusmedical.fr/v1/search",
      headers={"Authorization": f"Bearer {LOCUS_API_KEY}"},
      json={"query": "antibioprophylaxie chirurgie colorectale", "limit": 5},
  )
  resp.raise_for_status()
  print(resp.json()["units"])
  ```

  ```typescript TypeScript theme={null}
  const resp = await fetch("https://core.locusmedical.fr/v1/search", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.LOCUS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: "antibioprophylaxie chirurgie colorectale", limit: 5 }),
  });
  const { units } = await resp.json();
  ```
</CodeGroup>

Chaque endpoint renvoie du JSON structuré. Explorez-les tous, avec un exécuteur
de requêtes en direct, dans l'onglet **API Reference**.

## 2. Essayer dans le playground

L'onglet **API Reference** affiche chaque endpoint avec un playground interactif.
Cliquez sur **Authorization**, collez votre clé `lsk_…`, et lancez une requête
sans quitter la documentation.

## 3. Connecter un client MCP

Les mêmes capacités sont exposées comme outils MCP sur Streamable HTTP à `/mcp`.

```json theme={null}
{
  "mcpServers": {
    "locus": {
      "url": "https://mcp.locusmedical.fr/mcp",
      "headers": { "Authorization": "Bearer ${LOCUS_API_KEY}" }
    }
  }
}
```

Voir [Serveur MCP](/fr/mcp/overview) pour le catalogue d'outils et le routage.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/fr/authentication">
    Format de clé, hachage, quotas.
  </Card>

  <Card title="Capacités" icon="layer-group" href="/fr/capabilities/overview">
    Ce que fait chaque endpoint et quand l'utiliser.
  </Card>
</CardGroup>