Connecter votre IA

L’URL du serveur

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

https://backend.owlyscan.com/mcp/v1

Claude Desktop et claude.ai

1. Dans Claude, ouvrez Paramètres, puis Connecteurs.
2. Choisissez Ajouter un connecteur personnalisé et collez l’URL ci-dessus.
3. Connectez-vous avec votre e-mail professionnel quand votre navigateur le demande. C’est tout.

Claude Code

Ajoutez le serveur depuis votre terminal :

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

Ouvrez ensuite la commande /mcp dans Claude Code et choisissez OwlyScan pour vous connecter avec votre e-mail professionnel dans le navigateur.

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 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 :

{
  "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 de documents 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. Les extraits sont tout ce qu’il y a : demandez à votre IA de citer ces extraits et de ne pas deviner au-delà. 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.
• count_results compte pour une recherche. Un search_tor de la même requête dans les 20 minutes la partage, et parcourir les pages de résultats pendant ce temps est gratuit.
• Ne lui demandez pas de trouver une personne : ces requêtes ne donnent que des nombres.

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 l’est. 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. Appuyez sur Déconnecter : c’est effectif immédiatement. Où trouver la page.