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

# Configuration et intégration

> Configurez Topsort Prompts et intégrez via Agent API ou MCP.

## Options d'intégration

* **Agent API**: idéal pour les interfaces chat et conversations multi-tour
* **MCP Server**: idéal pour les intégrations personnalisées et l'accès direct aux outils

## Option 1: Agent API

### Endpoint

```text theme={null}
POST /topsort_prompts/chat
```

### Headers

```http theme={null}
X-API-Key: YOUR_API_KEY
Content-Type: application/json
```

### Exemple de requête

```json theme={null}
{
  "query": "I need running shoes under $150",
  "session_id": "user-session-123",
  "max_results": 10,
  "max_sponsored": 3,
  "streaming": false
}
```

Champs principaux: `query`, `session_id`, `max_results`, `max_sponsored`, `streaming`.

## Option 2: MCP Server

### Connexion

```text theme={null}
URL: https://mcp-server.api.topsort.ai/mcp
Transport: Streamable HTTP
```

```http theme={null}
X-API-Key: YOUR_API_KEY
```

Utilisez l'outil `search_products` avec des paramètres comme `query`, `max_results` et `max_sponsored`.

## Bonnes pratiques

* Identifiez clairement les placements sponsorisés (`is_sponsored: true`)
* Suivez `resolvedBidId` pour l'attribution
* Réutilisez `session_id` pour conserver le contexte
* Implémentez des retries avec backoff pour les erreurs `5xx`