> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/developpeurs/getting-started.md).

# Premiers pas

Instructions de configuration pour les assistants IA utilisant MCP

Connectez votre assistant IA à AirOps à l’aide du serveur MCP. Ce guide couvre la configuration pour Codex, Claude Code, Cursor, VS Code, Windsurf et d’autres clients MCP.

{% hint style="info" %}
**Claude Web ou Desktop ?** Utilisez la [Connecteur Claude](/docs/fr/developpeurs/claude-connector.md) pour une configuration en un clic et les applications interactives.
{% endhint %}

**URL du serveur :** `https://app.airops.com/mcp`

Les outils de ressources nécessitent un espace de travail AirOps payant, y compris les essais payants éligibles. Les espaces de travail gratuits peuvent se connecter et lister les espaces de travail, mais ne peuvent pas interroger ni modifier les données de l’espace de travail via MCP. Voir [l’accès au plan](/docs/fr/developpeurs/tools.md#plan-access).

L’authentification utilise OAuth 2.0 — connectez-vous avec votre compte AirOps via votre navigateur.

## Codex

Utilisez la [plugin AirOps MCP](/docs/fr/developpeurs/codex-plugin.md) pour une configuration en un clic dans Codex.

## Claude Code

Exécutez dans votre terminal :

```bash
claude mcp add --transport http airops https://app.airops.com/mcp
```

Puis authentifiez-vous :

1. Exécutez `/mcp` dans Claude Code
2. Sélectionnez le serveur AirOps
3. Choisissez **S’authentifier**
4. Terminez la connexion dans votre navigateur

## Cursor

1. Ouvrir **Cursor Settings → Tools & MCP → New MCP server**
2. Ajoutez la configuration :

```json
{
  "mcpServers": {
    "airops": {
      "url": "https://app.airops.com/mcp"
    }
  }
}
```

3. Cliquez sur **Connecter** pour s’authentifier

## VS Code (Copilot)

1. Ouvrir **Paramètres** (Ctrl/Cmd + ,)
2. Recherchez « mcp » et cliquez sur **Modifier dans settings.json**
3. Ajoutez :

```json
{
  "mcp": {
    "servers": {
      "airops": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
      }
    }
  }
}
```

## Windsurf

1. Ouvrir **Paramètres Windsurf → Cascade → Serveurs MCP**
2. Cliquez sur **Ajouter un serveur → Ajouter un serveur personnalisé**
3. Ajoutez :

```json
{
  "mcpServers": {
    "airops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
    }
  }
}
```

## Autres clients

La plupart des clients MCP prennent en charge le transport HTTP :

* **Transport :** HTTP (HTTP diffusable)
* **URL :** `https://app.airops.com/mcp`

Pour les clients nécessitant le transport SSE, utilisez `mcp-remote` comme proxy :

```bash
npx -y mcp-remote https://app.airops.com/mcp
```

## Dépannage

### Authentification

<details>

<summary>erreur « Nécessite une authentification »</summary>

**Claude Code :** Exécutez `/mcp`, sélectionnez AirOps, choisissez **S’authentifier**.

**Cursor :** Cliquez sur **Connecter** bouton dans les paramètres MCP.

**Autres clients :** Supprimez et rajoutez le serveur pour effacer les jetons mis en cache.

</details>

<details>

<summary>OAuth ne fonctionne pas (WSL/réseau d’entreprise)</summary>

**Utilisateurs WSL :** OAuth via le navigateur peut échouer depuis WSL. Exécutez plutôt votre client depuis Windows.

**Réseaux d’entreprise :** Votre réseau peut bloquer les redirections OAuth. Essayez un réseau personnel ou contactez l’IT pour autoriser `app.airops.com`.

</details>

### Connexion

<details>

<summary>Connexion refusée ou délai d’attente dépassé</summary>

Vérifiez que vous pouvez accéder à `https://app.airops.com` dans votre navigateur. Certains réseaux d’entreprise bloquent les connexions MCP.

</details>

<details>

<summary>Les outils n’apparaissent pas</summary>

1. Redémarrez votre assistant IA
2. **Claude Code :** Exécutez `/mcp` pour vérifier la connexion
3. Supprimez et rajoutez le serveur

</details>

### Effacer l’authentification mise en cache

Supprimez le serveur et ajoutez-le à nouveau :

**Claude Code :**

```bash
claude mcp remove airops
claude mcp add --transport http airops https://app.airops.com/mcp
```

**Autres clients :** Supprimez le serveur de votre configuration et rajoutez-le.

## Étapes suivantes

* [Cas d’usage](/docs/fr/developpeurs/use-cases.md) — Exemples de reporting et d’optimisation
* [Référence des outils](/docs/fr/developpeurs/tools.md) — Tous les outils disponibles
* [FAQ](/docs/fr/developpeurs/faq.md) — Questions fréquentes


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/developpeurs/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.