MCP

Connecter le serveur MCP

Teddit a un serveur MCP intégré. Connectez-le à Claude, Cursor ou un autre client MCP, et votre propre IA peut lire chaque réponse, source et chiffre de votre espace de travail, gérer les prompts et les concurrents, et lancer des analyses si la clé le permet.

Ce que vous obtenez

Le serveur fait partie de Teddit. Il n’y a rien à installer de notre côté ni à déployer.

Élément	Valeur
Adresse	`https://teddit.io/mcp`
Transport	Streamable HTTP, sans état : chaque requête se suffit à elle-même, il n’y a pas de session à garder ouverte.
Authentification	Une clé API de l’espace de travail dans l’en-tête `Authorization: Bearer tdt_…`
Contenu	30 outils, une ressource (`teddit://projects`) et deux modèles de prompt (`weekly_review`, `grow_prompt_set`). Tous sont listés dans la référence des outils.

Chaque appel d’outil passe par les mêmes vérifications que l’application web. Une clé ne peut jamais faire plus que ce que son niveau d’accès permet, et rien de ce qu’un outil fait n’est caché à l’application : une analyse lancée via MCP apparaît dans l’historique des analyses comme n’importe quelle autre.

La lecture est gratuite. Un seul outil coûte de l’argent : start_scan lance une analyse, payée depuis le solde de l’espace de travail. rewrite_queries n’est pas facturé, mais il a besoin d’un solde supérieur à zéro.

Créer une clé

Dans l’application, cliquez sur l’icône d’engrenage dans la barre du haut et ouvrez l’onglet API & MCP.
Appuyez sur Créer une clé. Donnez-lui un nom qui dit où elle sera utilisée, par exemple « Claude sur mon portable ».
Choisissez l’accès : Lecture, Lecture + édition ou Lecture + analyse.
Copiez la clé. Elle commence par tdt_ et n’est affichée qu’une fois. Teddit n’en garde qu’une empreinte et ne peut pas la réafficher.

Tout le monde dans l’espace de travail peut créer une clé ; ce qu’elle peut faire dépend du rôle de la personne. Une clé appartient à un seul espace de travail. Tant que la boîte de dialogue avec la nouvelle clé est ouverte, les extraits de configuration de la page API & MCP sont remplis avec elle, prêts à copier.

Pour mettre une clé hors service, appuyez sur l’icône de corbeille à côté d’elle. Elle cesse de fonctionner immédiatement. Plus sur les clés : Authentification.

Claude

Claude Code

Une seule commande ajoute le serveur en HTTP :

claude mcp add --transport http teddit https://teddit.io/mcp \
  --header "Authorization: Bearer tdt_…"

Claude Desktop

Claude Desktop démarre les serveurs MCP comme des programmes locaux à partir de son fichier de configuration. Un petit pont, le paquet open source mcp-remote, le connecte à l’adresse de Teddit et envoie la clé. Il a besoin de Node.js. Ajoutez ceci à claude_desktop_config.json et redémarrez Claude :

{
  "mcpServers": {
    "teddit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://teddit.io/mcp", "--header", "Authorization:${TEDDIT_AUTH}"],
      "env": {
        "TEDDIT_AUTH": "Bearer tdt_…"
      }
    }
  }
}

La clé va dans TEDDIT_AUTH, après Bearer et une espace.

ChatGPT

ChatGPT ajoute les serveurs MCP distants comme connecteurs, par adresse. Pour connecter Teddit, le connecteur doit envoyer votre clé dans l’en-tête Authorization :

Name:  Teddit
URL:   https://teddit.io/mcp
Auth:  Bearer tdt_…

Teddit accepte une clé dans l’en-tête Authorization et rien d’autre. Il n’a pas de connexion OAuth. Un client dont le formulaire de connecteur ne propose qu’OAuth, ou aucun moyen d’envoyer un en-tête, ne peut pas s’y connecter directement.

Cursor et autres clients

Tout client qui parle MCP en Streamable HTTP et peut envoyer un en-tête fonctionne. Pour Cursor, mettez ceci dans .cursor/mcp.json :

{
  "mcpServers": {
    "teddit": {
      "type": "http",
      "url": "https://teddit.io/mcp",
      "headers": {
        "Authorization": "Bearer tdt_…"
      }
    }
  }
}

Pour un client que vous configurez à la main, voici les trois informations dont il a besoin :

l’adresse https://teddit.io/mcp ;
le transport : Streamable HTTP ;
l’en-tête Authorization: Bearer tdt_… sur chaque requête.

Un client qui ne peut que lancer des programmes locaux peut utiliser le pont mcp-remote montré sous Claude Desktop.

Vérifier la connexion

Demandez à votre IA : « Utilise Teddit et dis-moi à quel espace de travail tu es connectée. » Elle devrait appeler whoami et répondre avec le nom de l’espace de travail et le niveau d’accès de la clé.

Pour tester une clé sans aucun client, appelez l’API directement :

curl https://teddit.io/api/whoami \
  -H "Authorization: Bearer tdt_…"

Ce que vous voyez	Ce que cela veut dire
HTTP 401 depuis `/mcp`	Aucune clé n’a été envoyée, l’en-tête n’est pas de la forme `Bearer tdt_…`, ou la clé a été révoquée. Une connexion dans le navigateur ne compte pas ici ; l’adresse MCP n’accepte que des clés.
Un outil répond `Error: You do not have permission to do that.`	Le niveau d’accès de la clé est trop bas pour cet outil. Créez une clé avec plus d’accès.
Un outil répond `Error: Project not found.`	L’identifiant du site est faux, ou le site appartient à un autre espace de travail. Les identifiants viennent de `list_projects`.

Ce qu’une clé peut faire

Accès	Outils qu’elle peut utiliser
Lecture	Tout ce qui lit : rapports, tendances, prompts et leurs réponses, concurrents, pages, historique et progression des analyses, estimations de coût, graphiques.
Lecture + édition	Ce qui précède, et : ajouter, modifier, mettre en pause, importer et supprimer des prompts ; ajouter, modifier et retirer des concurrents ; changer les réglages d’un site ; relire le sitemap.
Lecture + analyse	Ce qui précède, et : lancer et annuler des analyses, réécrire les requêtes importées en questions, et ajouter un site.

Vous ne pouvez pas créer une clé avec plus d’accès que vous n’en avez vous-même. Les analyses lancées avec une clé sont payées depuis le même solde et comptent dans les mêmes limites que les analyses lancées dans l’application, et sont enregistrées au nom de la personne qui a créé la clé.

Ensuite : la référence des outils et quelques exemples de questions.

Précédent‹ Accès des robots IA SuivantRéférence des outils ›