Un serveur MCP de navigateur avec une vraie identité
Ajoutez Clearcote à la configuration de votre client MCP : le modèle obtient un navigateur dans lequel il peut lire, cliquer et taper grâce à vingt outils. L'identité est définie une seule fois, dans des variables d'environnement : la liste d'outils reste courte et l'empreinte reste cohérente pendant que l'agent travaille.
Exécute le build ouvert sans clé. Ajoutez une clé GitHub gratuite pour obtenir le dernier build.
Ajoutez-le à la configuration de votre client
{
"mcpServers": {
"clearcote": {
"command": "npx",
"args": ["-y", "clearcote-mcp"],
"env": {
"CLEARCOTE_FINGERPRINT": "acct-1",
"CLEARCOTE_TIMEZONE": "America/New_York",
"CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
}
}
}
}Points clés
Vingt outils
navigate, read_page, page_elements, click, fill_field et screenshot_page, plus l'attente, les appuis de touche, les onglets, les cookies, les PDF et les sessions enregistrées.
L'identité hors du prompt
Seed, plateforme, marque, langue et fuseau horaire sont des variables d'environnement CLEARCOTE_*. Le modèle n'a jamais à raisonner sur les empreintes.
Les clients que vous utilisez déjà
Claude Desktop, Cursor et Cline partagent la même structure de configuration. Installez-le depuis PyPI, puis lancez-le directement ou via le lanceur npx.
Pas de switch d'automatisation
Le serveur démarre le navigateur sans le switch d'automatisation de Playwright : navigator.webdriver reste à false, et le moteur tient les effets de bord habituels de CDP à l'écart de la page.
Une porte de sortie vers le CDP brut
get_cdp_endpoint renvoie l'URL CDP du navigateur : un script peut reprendre exactement la session dans laquelle travaillait l'agent.
Le dernier build, en une variable
Ajoutez CLEARCOTE_LICENSE_KEY pour exécuter le dernier build sous licence au lieu du build ouvert.
Comment fonctionne le serveur MCP
Le serveur démarre un navigateur Clearcote et le conserve tant qu'il tourne. Chaque appel d'outil agit sur ce navigateur partagé : le modèle lit la page en texte ou en markdown, liste les liens, boutons et champs visibles avec, pour chacun, un sélecteur CSS quand il en existe un, puis agit dessus avec ces sélecteurs, si bien qu'il a rarement besoin d'écrire les siens.
L'identité est fixée au démarrage du serveur. Les bases du persona (seed, plateforme, marque, langue, fuseau horaire, proxy et geoip) sont des variables CLEARCOTE_* : une entrée de serveur correspond à une identité, et aucun outil ne peut la modifier en cours de tâche. Pour le reste des flags d'empreinte, utilisez directement le SDK.
Il y a deux façons de confier les commandes de Clearcote à un modèle. Ce serveur garde le modèle hors du navigateur, où il appelle des outils. L'agent intégré au navigateur, lui, s'exécute dans le processus du navigateur et dialogue avec un endpoint compatible OpenAI de votre choix.
Les outils les plus utilisés
| Outil | Ce qu'il fait |
|---|---|
read_page | Lit la page en direct, en texte ou en markdown |
page_elements | Liste jusqu'à 200 liens, boutons et champs visibles, chacun avec un sélecteur CSS quand il en existe un |
click | Clique sur un élément |
fill_field | Saisit du texte dans un input ou un textarea |
screenshot_page | Capture d'écran PNG de la page entière, enregistrée dans le dossier d'écriture du serveur |
navigate | Charge une URL dans l'onglet courant et renvoie l'URL finale et le titre |
save_profile | Enregistre les cookies et le stockage dans un fichier nommé, pour restaurer les cookies plus tard |
get_cdp_endpoint | Renvoie l'URL CDP pour un client brut |
S'y ajoutent get_page_html, press_key, wait_for, evaluate_js, current_page, get_cookies, list_tabs, new_tab, close_tab, load_profile, get_egress_info et save_page_pdf (headless uniquement).
Cas d'usage
Recherche avec un vrai navigateur
Laissez le modèle lire des pages qui ont besoin de JavaScript pour s'afficher, plutôt qu'un simple fetch en texte brut.
Corvées web récurrentes
Inscriptions, pages de paramètres et tableaux de bord que vous parcourriez sinon à la main.
Débogage avec un assistant
Demandez à Cursor de reproduire un bug sur votre site de staging et de faire une capture d'écran à chaque étape.
Prototyper une automatisation
Parcourez un flux avec le modèle, puis récupérez l'endpoint CDP et scriptez-le.
Clearcote est conçu pour la confidentialité, les tests, la recherche et l'automatisation licite. Vous êtes responsable de l'usage que vous en faites et du respect des conditions d'utilisation des sites que vous visitez.
Offres qui l'incluent
Le serveur MCP est gratuit dans toutes les formules. Il exécute le build ouvert, sauf s'il trouve une clé de licence (CLEARCOTE_LICENSE_KEY, ou une clé enregistrée par clearcote login) ; une clé GitHub gratuite exécute le dernier build, un navigateur à la fois.
FAQ
Avec quels clients MCP fonctionne-t-il ?
Les clients qui lancent des serveurs MCP depuis un fichier de configuration. Claude Desktop est illustré ci-dessus ; Cursor et Cline utilisent la même structure.
Le modèle contrôle-t-il l'empreinte ?
Non. L'identité provient de variables d'environnement au démarrage du serveur, et aucun outil ne la modifie. Le persona reste ainsi cohérent pendant toute la session, et la liste d'outils reste courte.
Ai-je besoin de Node ou de Python ?
Python 3.10 ou plus récent, dans les deux cas : le package npm est un lanceur pour le même serveur Python. Installez-le avec pip en épinglant mcp sous la 2.0, comme dans le bloc d'installation ci-dessus (clearcote-mcp 0.1.0 ne fonctionne pas avec mcp 2.x), puis utilisez clearcote-mcp ou npx -y clearcote-mcp comme commande.
Quelle différence avec l'agent intégré au navigateur ?
Le serveur MCP permet à un modèle externe (celui de votre client de chat) de piloter le navigateur au moyen d'outils. L'agent intégré s'exécute dans le navigateur et appelle un endpoint de modèle que vous configurez. Les deux pilotent le même moteur.
Un script peut-il reprendre la session de l'agent ?
Oui. get_cdp_endpoint renvoie l'URL CDP du navigateur qu'utilise l'agent, et Playwright ou Puppeteer peuvent s'y connecter.
Aller plus loin dans la documentation
Fonctionnalités associées
Donnez à browser-use, Stagehand, Crawl4AI ou à votre propre agent un Chromium dont l'identité est définie au niveau du moteur, ou lancez l'agent intégré optionnel de Clearcote avec votre propre modèle.
Exécutez Clearcote comme endpoint CDP permanent depuis l'image Docker officielle, serve() ou une CLI, et connectez n'importe quel framework sans toucher au code.
Démarrez un navigateur Clearcote dans le cloud en un seul appel d'API et connectez Playwright ou Puppeteer via CDP. IP résidentielle incluse, facturation au GB de trafic.
Canvas, WebGL, WebGPU, audio, polices, écran et matériel dérivés d'un seul seed dans le moteur C++, avec la locale et le fuseau horaire assortis : chaque surface concorde avec toutes les autres.
À lire aussi
Essayer Clearcote
S'utilise tel quel avec Playwright et Puppeteer, cohérent jusqu'au handshake TLS, avec un build open source comme point de départ.
Gratuit pour un navigateur avec GitHub. Sans carte.