Aller au contenu

Open source · auto-hébergé · serveur MCP distant

Plusieurs boîtes Gmail, un seul connecteur Claude.

Surfski permet à Claude de rechercher, lire et rédiger des e-mails dans plusieurs boîtes Gmail et Google Workspace. Vous ajoutez un seul connecteur, vous liez autant de boîtes que vous le souhaitez, et chaque utilisateur ne voit jamais que les siennes.

Fonctionne avec Claude sur le web, sur ordinateur et sur mobile, ainsi qu’avec tout client MCP compatible Streamable HTTP avec OAuth.

« Trouvez tout ce qui vient d’Acme dans mes boîtes de réception ce mois-ci. »

search_all_accounts(query="from:acme newer_than:30d")

  • workFacture n° 4821 — octobreAcme Billing18 oct.
  • personalVotre commande a été expédiéeAcme Store15 oct.
  • supportRe : remboursement de la facture n° 4790[email protected]12 oct.
Illustration. Trois boîtes, une seule recherche.

Comment ça marche

Deux connexions Google distinctes séparent deux questions : quel utilisateur de Claude fait la demande, et à quelles boîtes cet utilisateur a donné accès. Les deux utilisent le même client OAuth, dans votre propre projet Google Cloud.

  1. 1Couche A · Qui vous êtes

    Ajoutez Surfski à Claude une seule fois

    Ajoutez votre serveur comme connecteur personnalisé et connectez-vous avec Google. Surfski vérifie seulement votre identité par rapport à sa liste d’autorisation. Il ne voit jamais votre mot de passe.

    Portées : openid, email

  2. 2Couche B · Quelles boîtes

    Liez chaque boîte sous un alias

    Demandez à Claude de « lier mon Gmail pro sous l’alias work ». Vous vous connectez avec cette boîte et accordez l’accès en lecture et en rédaction. Recommencez pour personal, support, etc.

    Portées : gmail.readonly, gmail.compose

  3. 3Ensuite

    Interrogez-les toutes à la fois

    Claude recherche, lit les fils de discussion et enregistre des brouillons dans la boîte que vous indiquez, ou dans toutes les boîtes que vous avez liées.

Ce que vous obtenez

Plusieurs boîtes par personne

Liez autant de comptes Gmail et Google Workspace que vous le souhaitez, chacun sous un alias court comme work, personal ou support.

Une recherche dans toutes les boîtes

Une seule recherche couvre toutes vos boîtes liées et indique de quelle boîte provient chaque fil.

Les brouillons d’abord

Claude rédige des brouillons, et c’est vous qui les envoyez depuis Gmail. L’envoi sur activation, avec liens de confirmation et plafonds quotidiens, figure sur la feuille de route.

Lire la conception de l’envoi →

Isolation stricte par utilisateur

Chaque requête est limitée à l’utilisateur Claude connecté. Les personnes qui partagent un serveur ne voient jamais les boîtes des autres.

Chiffré au repos

Les jetons d’actualisation sont chiffrés avec Fernet sur votre serveur. Les jetons d’accès restent en mémoire. Les journaux ne contiennent jamais de jetons ni de corps de messages.

Votre projet Google, votre serveur

L’auto-hébergement utilise votre propre client OAuth, ce qui vous dispense de la vérification d’application de Google. Cela fonctionne jusqu’à 100 utilisateurs.

Hébergez votre propre instance

Les portées de lecture de Gmail sont restreintes. Une application publique doit passer la vérification de Google et une évaluation de sécurité annuelle. Votre propre instance en est dispensée, tant qu’elle reste sous les 100 utilisateurs.

  • Votre propre projet Google Cloud et votre propre client OAuth.
  • Les jetons d’actualisation ne quittent jamais votre serveur.
  • Un seul conteneur Docker derrière votre proxy inverse TLS.
# sur un hôte Linux avec Docker
git clone https://github.com/rayhu/surfski /opt/surfski
cd /opt/surfski
python3 scripts/gen_secrets.py
sudo docker compose -p surfski up -d --build

# puis dans Claude : Paramètres → Connecteurs
# → Ajouter un connecteur personnalisé → https://<host>/mcp

Plus tard

Une version hébergée

Une version hébergée de Surfski est prévue par étapes : d’abord une bêta sur invitation, puis un hébergement pour les organisations Google Workspace qui fournissent leur propre client OAuth interne, et un hébergement public en libre-service seulement après la vérification OAuth de Google et l’évaluation de sécurité annuelle. Il n’y a pas encore de date ni d’inscription.