Connecter votre IA

Mis à jour le

Votre IA cherche dans OwlyScan à votre place et résume ce qu’elle trouve.

Pour la présentation générale, consultez la page MCP.

L’URL du serveur

OwlyScan est un serveur MCP. Ajoutez-le à votre application d’IA avec cette URL :

URL du serveur MCP
https://backend.owlyscan.com/mcp/v1

Claude Desktop et claude.ai

  1. Dans Claude, allez dans Customize > Connectors.
  2. Choisissez Add, puis Add custom connector. Saisissez un nom et l’URL ci-dessus, puis cliquez sur Continue.
  3. Cliquez sur Add. Si le connecteur affiche Connect, cliquez dessus et connectez-vous avec votre e-mail professionnel quand votre navigateur le demande : nous vous envoyons un code à 6 chiffres par e-mail.

Claude Code

Ajoutez le serveur depuis votre terminal :

Terminal
claude mcp add --transport http owlyscan https://backend.owlyscan.com/mcp/v1

Lancez ensuite la commande /mcp dans Claude Code et choisissez OwlyScan pour vous connecter avec votre e-mail professionnel dans le navigateur : nous vous envoyons un code à 6 chiffres par e-mail.

Avec une clé d’API

Pour un script ou un programme, une clé owly_ fonctionne sur ce même point d’accès MCP et sur la route de recherche. Créez la clé dans l’application. Clés d’API. Traitez-la comme un mot de passe.

Dans Claude Code, ajoutez la clé en en-tête. --header "X-API-Key: owly_YOUR_KEY" fonctionne aussi.

Claude Code avec une clé
claude mcp add --transport http owlyscan https://backend.owlyscan.com/mcp/v1 \
  --header "Authorization: Bearer owly_YOUR_KEY"

Pour le fichier .mcp.json ou les paramètres de Claude Code, l’entrée ressemble à ceci :

Configuration JSON
{
  "mcpServers": {
    "owlyscan": {
      "type": "http",
      "url": "https://backend.owlyscan.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer owly_YOUR_KEY"
      }
    }
  }
}

Ce que votre IA peut faire

Un compte Access dispose de deux outils :

  • count_results donne le nombre d’enregistrements qui correspondent à une requête et leur répartition par canal.
  • search_tor renvoie une page de résultats sous forme d’extraits, chacun avec son canal et sa date, et indique ce que vous pouvez lire de chacun : à vous, probablement à vous, noms masqués ou valeurs masquées.

Il n’existe pas d’outil pour ouvrir un document entier. Il n’y a que des extraits : demandez à votre IA de les citer et de ne pas deviner au-delà. Dans Access, les documents qui ne sont pas à vous n’affichent ni adresse web ni nom de fichier. Dans vos enregistrements, les mots de passe et les empreintes (hash) sont masqués : on n’en voit que la longueur et au plus les deux premiers caractères.

Les bons réflexes

  • Demandez-lui de compter d’abord, puis de chercher quand le nombre est raisonnable.
  • Donnez-lui votre domaine et les noms de votre entreprise.
  • La même requête dans les 20 minutes ne compte qu’une fois, que votre IA appelle count_results ou search_tor. Parcourir les pages de résultats pendant ce temps est gratuit.
  • Ne lui demandez pas de trouver une personne : ces requêtes ne renvoient que des totaux.

Si quelque chose ne va pas

  • Limite de la semaine atteinte. L’outil le dit et donne l’heure de remise à zéro. Limites.
  • Trop de recherches en même temps. Attendez quelques secondes et réessayez une fois.
  • Une requête que nous n’exécutons pas. Reformulez-la.
  • Abonnement inactif. Les recherches s’arrêtent tant qu’il n’est pas réactivé. Voir facturation.
  • Aucun outil n’apparaît. Redémarrez votre application d’IA après avoir ajouté le serveur.

Se déconnecter

Ouvrez Clés d’API et connexion IA dans l’application. Les applications d’IA que vous avez connectées, comme Claude, sont listées sous Applications d’IA connectées. Cliquez sur Déconnecter : c’est effectif immédiatement. Où trouver la page.