---
title: "API et serveur MCP Weftd - Développeurs"
description: "L'API publique et le serveur MCP de Weftd : URL de base, authentification, endpoints, exemples de requêtes, erreurs et fichiers lisibles par les machines qui les décrivent."
url: https://www.weftd.com/fr/developers
locale: fr
alternates:
  en: https://www.weftd.com/developers
  fr: https://www.weftd.com/fr/developers
---

# API et serveur MCP Weftd

La Présence IA de Weftd est accessible aux programmes autant qu'aux personnes : une API HTTP qui répond aux questions sur Weftd, et un serveur MCP pour les assistants IA. Les deux sont publics et ne demandent aucune clé.

## En bref

| Surface | URL | Description |
| --- | --- | --- |
| API HTTP | https://weftd.weftd.space/api/v1 | Posez une question en langage naturel, recevez du JSON ou du texte brut. weftd.com/api/v1 redirige ici ; /api est un alias de la version courante. |
| OpenAPI | https://www.weftd.com/openapi.json | Description OpenAPI 3.1 de l'API HTTP. |
| Serveur MCP | https://weftd.weftd.space/mcp | Endpoint Streamable HTTP pour les assistants IA (Claude, ChatGPT, Cursor…). |

## Authentification

Aucune pour le space public de Weftd : appelez l'API et connectez le serveur MCP sans clé ni compte.

La même API existe pour chaque Présence IA construite avec Weftd. Un space privé exige une clé d'API, créée dans les réglages « Developer API » de ce space et envoyée en Authorization: Bearer <clé> ou X-API-Key: <clé>.

## Endpoint : GET /api/v1

Posez une question à Weftd. POST /api/v1 accepte les mêmes champs dans un corps JSON.

| Paramètre | Requis | Valeurs | Description |
| --- | --- | --- | --- |
| query | oui | texte | La question, en langage naturel. |
| mode | non | context (défaut), search | context : une réponse rédigée par l'IA, avec ses sources. search : les entrées de connaissance classées par pertinence, sans IA. |
| type | non | txt (défaut), json | Texte brut ou JSON structuré. |
| limit | non | 1–50, 4 par défaut | Nombre maximal d'entrées utilisées ou renvoyées. |

## Exemples de requêtes

**Entrées classées, en JSON**

```bash
curl "https://weftd.weftd.space/api/v1?query=Combien%20co%C3%BBte%20Weftd%20%3F&mode=search&type=json&limit=2"
```

**Une réponse rédigée par l'IA, avec ses sources**

```bash
curl -X POST https://weftd.weftd.space/api/v1 \
  -H "Content-Type: application/json" \
  -d '{"query": "Qu’est-ce qu’une Présence IA ?", "mode": "context", "type": "json"}'
```

**Réponse (mode=search, type=json)**

```json
{
  "results": [
    { "id": "…", "title": "Weftd Plans and Pricing: Free to Enterprise", "snippet": "Weftd starts for free…", "relevance": 0.011 }
  ],
  "total": 1,
  "query": "Combien coûte Weftd ?"
}
```

## Erreurs et limites de débit

Les erreurs sont en JSON, avec un champ error et, si utile, un code et un message : 400 pour une query absente ou une limit hors de 1–50, 403 pour un space privé sans clé valide, 404 pour un chemin inconnu, 429 quand la limite de débit est atteinte.

Les requêtes sont limitées par adresse IP. Chaque réponse porte les en-têtes RateLimit de l'IETF : RateLimit-Policy donne le quota et sa fenêtre, RateLimit les requêtes restantes et les secondes avant la remise à zéro. Un 429 porte en plus Retry-After : attendez ce nombre de secondes avant de réessayer.

## Versions et dépréciation

La version est dans le chemin : /api/v1. Les évolutions qui ne cassent aucune requête existante (un nouveau paramètre optionnel, un nouveau champ de réponse) arrivent dans la v1. Un changement incompatible arrive sous un nouveau chemin, /api/v2, et la v1 continue de répondre.

Une version en fin de vie l'annonce sur chaque réponse : un en-tête Deprecation (RFC 9745), un en-tête Sunset (RFC 8594) avec sa date de retrait, au moins six mois à l'avance, et un en-tête Link rel="successor-version" vers la version qui la remplace. Le document OpenAPI énonce la même politique dans x-api-lifecycle.

## Connecter le serveur MCP

Ajoutez https://weftd.weftd.space/mcp à votre assistant comme connecteur personnalisé. L'assistant peut alors chercher dans la connaissance de Weftd et envoyer un message à l'équipe.

**Claude Code**

```bash
claude mcp add --transport http weftd https://weftd.weftd.space/mcp
```

**Tout client MCP (configuration JSON)**

```json
{
  "mcpServers": {
    "weftd": { "type": "http", "url": "https://weftd.weftd.space/mcp" }
  }
}
```

## Fichiers lisibles par les machines

- [/openapi.json](https://www.weftd.com/openapi.json): Le document OpenAPI 3.1 de l'API HTTP.
- [/.well-known/api-catalog](https://www.weftd.com/.well-known/api-catalog): Catalogue d'API (RFC 9727) qui pointe vers ce document.
- [/.well-known/mcp/server-card.json](https://www.weftd.com/.well-known/mcp/server-card.json): Identité, version et endpoint du serveur MCP.
- [/.well-known/ard.json](https://www.weftd.com/.well-known/ard.json): Catalogue Agentic Resource Discovery.
- [/llms.txt](https://www.weftd.com/fr/llms.txt): Index du site pour les modèles de langage, avec une version Markdown de chaque page.
