docs.semactic › MCP
Connecter Semactic à un agent ou à un autre client MCP
Semactic propose deux serveurs MCP : celui de la documentation, ouvert à tous sans compte, et celui de vos données Semactic, réservé aux clients (add-on MCP et clé API).
Cette page donne leurs paramètres sous une forme qu'un agent IA ou un client MCP en ligne de commande peut appliquer directement. Pour l'interface de Claude ou de ChatGPT, suivez plutôt Connecter Semactic à Claude ou Connecter Semactic à ChatGPT.
Documentation : serveur public, sans compte
Le serveur MCP de la documentation est en lecture seule et ne demande ni compte ni clé : https://docs.semactic.com/mcp/public.
claude mcp add --transport http semactic-docs-public https://docs.semactic.com/mcp/public
Données Semactic : paramètres du serveur
| Paramètre | Valeur |
|---|---|
| URL du serveur | https://mcp.semactic.com/mcp |
| Transport | HTTP (Streamable HTTP) |
| Authentification | OAuth, code d'autorisation avec PKCE (S256) |
| Enregistrement du client | Dynamique : laissez l'identifiant et le secret client OAuth vides |
| Identifiant demandé | Votre clé API Semactic, saisie dans la page d'autorisation |
[!NOTE] Le serveur MCP nécessite l'add-on MCP. Votre clé API se trouve sur la carte Semactic API de la page Integration : voir API Semactic et serveur MCP.
Ce que l'agent fait, ce que vous faites
- L'agent ajoute le serveur à la configuration de son client MCP et lance l'autorisation.
- Vous collez votre clé API dans la page d'autorisation qui s'ouvre dans votre navigateur, puis cliquez sur Authorize.
[!WARNING] Ne collez pas votre clé API dans une conversation et ne l'écrivez pas dans un fichier de configuration : saisissez-la uniquement dans la page d'autorisation de Semactic. Toute personne qui possède cette clé peut lire vos données.
Claude Code
Ajoutez le serveur :
claude mcp add --transport http semactic https://mcp.semactic.com/mcp
Dans Claude Code, tapez ensuite /mcp, choisissez semactic et lancez l'authentification. Votre navigateur s'ouvre : collez votre clé API et cliquez sur Authorize.
Fichier de configuration JSON
Pour un client qui lit un fichier de configuration (par exemple .mcp.json pour Claude Code) :
{
"mcpServers": {
"semactic": {
"type": "http",
"url": "https://mcp.semactic.com/mcp"
}
}
}
Le nom exact des champs dépend du client : certains attendent streamable-http comme type, d'autres seulement l'URL. Reprenez l'URL et le transport du tableau ci-dessus dans le format de votre client.
Vérifier la connexion
Demandez à l'agent d'appeler get_my_account_context, puis list_projects : il doit obtenir votre compte et vos projets. La liste complète des outils est décrite dans Outils MCP Semactic : vue d'ensemble.
Si la connexion échoue
- Le serveur répond 401 : l'autorisation n'a pas été faite ou a expiré. Relancez l'authentification depuis votre client.
- La clé est refusée : vérifiez que l'add-on MCP est actif et que la clé est la bonne. Après Rafraîchir la clé, l'ancienne clé cesse immédiatement de fonctionner.