Hubity

npx add-mcp 'https://hubity.io/api/mcp'

Serveur MCP Hubity : connectez n'importe quel assistant

La tâche la plus courante est la facturation du mois : un assistant prévisualise chaque facture à partir des heures approuvées, des dépenses, des honoraires et de l'avancement des contrats, puis les prépare pour qu'une personne les examine et les envoie dans Hubity. La lecture nécessite votre connexion et votre approbation, et suit votre rôle ; les trois actions qui modifient des données nécessitent un accès en écriture que vous approuvez.

Gratuit sur Starter pour jusqu'à 3 personnes. Aucune carte requise.

Vue d'ensemble

Hubity exécute un serveur Model Context Protocol (MCP) distant à https://hubity.io/api/mcp. Un assistant connecté peut facturer le mois (prévisualiser chaque facture, puis les préparer pour examen), lire les projets, tâches, personnes, clients et affaires, propositions et factures, réunions et congés, et rechercher dans la base de connaissances de l'entreprise, toujours limité à ce que la personne connectée est autorisée à voir.

Trois outils modifient des données : log_time_entry enregistre le temps, create_invoice_from_proposal transforme une proposition acceptée en facture provisoire, et create_month_invoice_drafts prépare les factures d'un mois pour examen. Aucun d'eux n'envoie quoi que ce soit à un client. Les trois nécessitent un accès en écriture (mcp:write), qui n'est accordé que lorsque la personne qui se connecte l'approuve sur l'écran de consentement Hubity. Tous les autres outils sont en lecture seule.

Le serveur implémente MCP 2026-07-28 sur Streamable HTTP (requêtes sans état, server/discover) et accepte toujours les clients qui ouvrent avec la poignée de main 2025-11-25 initialize. OAuth 2.1 avec PKCE est la connexion principale, et chaque connexion affiche un écran de consentement Hubity listant exactement ce que l'assistant peut faire. Les codes d'accès en lecture seule, créés dans The Hub sous Intégrations, fonctionnent pour les clients en ligne de commande et les scripts.

Connexion

Clients pris en charge : Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (via Copilot Studio), Grok, Gemini, Cursor, VS Code et Windsurf. Chacun vous connecte à Hubity avec OAuth et affiche l'écran de consentement, où vous choisissez Autoriser l'accès ou Refuser.

Claude et Claude Desktop

Dans Claude, ouvrez Customize → Connectors → Add → Add custom connector et collez https://hubity.io/api/mcp (sur Team et Enterprise, un propriétaire l'ajoute d'abord sous Organization settings → Connectors). Claude Desktop utilise les mêmes connecteurs. Claude vous connecte à Hubity et affiche l'écran de consentement ; autorisez l'accès et les outils apparaissent.

Pour utiliser un code d'accès en lecture seule dans Claude Desktop à la place, ajoutez une entrée de pont à claude_desktop_config.json (nécessite Node.js) :

{
  "mcpServers": {
    "hubity": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubity.io/api/mcp",
               "--header", "Authorization: Bearer <access code>"]
    }
  }
}

Claude Code

Claude Code (le CLI) enregistre les serveurs avec une seule commande. Pour vous connecter avec la connexion par navigateur (aucun code à gérer) :

claude mcp add --transport http hubity https://hubity.io/api/mcp

Ensuite, exécutez /mcp dans Claude Code et approuvez la connexion Hubity. Pour utiliser un code d'accès en lecture seule à la place (pratique pour les scripts et l'intégration continue), transmettez-le comme en-tête :

claude mcp add --transport http hubity https://hubity.io/api/mcp \
 --header "Authorization: Bearer <access code>"

Ajoutez --scope user pour rendre la connexion disponible sur tous vos projets, ou engagez un .mcp.json de projet pour le partager avec votre équipe. Vérifiez avec claude mcp list.

ChatGPT

1. Dans les paramètres de ChatGPT, activez le mode Développeur. Sur un espace de travail Business, Enterprise ou Edu, un administrateur peut devoir l'autoriser d'abord.
2. Créez une nouvelle application ou un nouveau connecteur, nommez-le Hubity, collez https://hubity.io/api/mcp comme URL du serveur MCP, et choisissez OAuth pour l'authentification.
3. ChatGPT vous connecte à Hubity et affiche l'écran de consentement. Autorisez l'accès et les outils apparaissent dans vos conversations.

ChatGPT se connecte d'abord avec un accès en lecture. La première fois que vous lui demandez d'enregistrer du temps ou de préparer une facture, Hubity vous demande d'autoriser l'accès en écriture ; approuvez-le sur l'écran de consentement et l'action s'exécute.

Microsoft Copilot

Dans Copilot Studio, ouvrez l'agent, puis Tools → Add a tool → New tool → Model Context Protocol. Nommez-le Hubity, collez https://hubity.io/api/mcp comme URL du serveur, et choisissez OAuth 2.0 avec Découverte dynamique. Créez une nouvelle connexion, connectez-vous à Hubity, autorisez l'accès, puis ajoutez l'outil à l'agent. Pas à pas : Hubity pour Copilot.

Grok

Allez sur grok.com/connectors, choisissez Nouveau connecteur, puis Personnalisé, et collez https://hubity.io/api/mcp. Grok vous connecte à Hubity et affiche l'écran de consentement. Sur une équipe Grok Business ou Enterprise, un administrateur ajoute d'abord les connecteurs.

Gemini

Sur gemini.google.com, ouvrez Settings → Connected Apps, choisissez Ajouter une application personnalisée, collez https://hubity.io/api/mcp, et sélectionnez Suivant. Hubity enregistre Gemini automatiquement, donc aucune information d'identification client n'est nécessaire ; connectez-vous et autorisez l'accès. Google propose actuellement les applications personnalisées uniquement en anglais, aux personnes de 18 ans ou plus aux États-Unis utilisant un compte Google personnel.

Cursor

Ajoutez Hubity à ~/.cursor/mcp.json, puis connectez-vous lorsque Cursor vous y invite :

{
  "mcpServers": {
    "hubity": { "url": "https://hubity.io/api/mcp" }
  }
}

VS Code

Ajoutez Hubity à .vscode/mcp.json, puis connectez-vous lorsque VS Code vous y invite :

{
  "servers": {
    "hubity": { "type": "http", "url": "https://hubity.io/api/mcp" }
  }
}

Windsurf

Ajoutez Hubity à ~/.codeium/windsurf/mcp_config.json, puis connectez-vous lorsque Windsurf vous y invite :

{
  "mcpServers": {
    "hubity": { "serverUrl": "https://hubity.io/api/mcp" }
  }
}

Point de terminaison

POST https://hubity.io/api/mcp
Content-Type: application/json
Authorization: Bearer <access code>
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search_knowledge

Découverte

• /.well-known/mcp/server-card.json : la carte du serveur, avec chaque outil et son schéma d'entrée, plus les invites et les ressources. Également servie à /.well-known/mcp.
• /api/mcp/server.json : l'entrée du registre MCP officiel.
• /.well-known/oauth-authorization-server : métadonnées du serveur d'autorisation OAuth 2.1 (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp : métadonnées de ressource protégée pour le point de terminaison MCP (RFC 9728).

Authentification

OAuth 2.1 (recommandé)

• Point de terminaison d'autorisation : https://hubity.io/api/mcp/oauth/authorize
• Point de terminaison de jeton : https://hubity.io/api/mcp/token
• Enregistrement du client : documents de métadonnées d'ID client (un client_id HTTPS, préféré), ou enregistrement RFC 7591 pour les clients publics à https://hubity.io/api/mcp/oauth/register
• Chaque autorisation affiche un écran de consentement ; l'accès en écriture (mcp:write) n'est accordé que là
• PKCE est requis ; code_challenge_method doit être S256
• Les jetons d'actualisation tournent à chaque utilisation

Codes d'accès

Pour les scripts et l'utilisation en ligne de commande, un administrateur crée un code d'accès en lecture seule, limité à l'entreprise, à The Hub → Integrations → Connect an AI assistant. Un code peut être limité et recevoir une expiration lors de sa création, et être désactivé à tout moment. Chaque requête est enregistrée dans le journal d'activité de l'entreprise.

Portées

• knowledge:read : rechercher et lire les documents de connaissances de l'entreprise
• mcp:read : accès en lecture sur les projets, tâches, personnel, facturation, CRM, réunions et congés
• mcp:write : les trois outils d'écriture (saisies de temps, factures à partir de propositions acceptées, brouillons de factures mensuelles)

Outils

La liste d'outils faisant autorité, avec le schéma d'entrée de chaque outil, est tools/list sur le protocole MCP en direct ou le tableau tools dans la carte du serveur. Catégories :

Chaque outil de liste sauf list_pto_requests lit également un enregistrement complet lorsqu'on lui donne son identifiant d'un résultat précédent, et search_knowledge fait de même pour un document.

Connaissances

• search_knowledge

Projets et tâches

• list_projects, get_project_profitability
• list_tasks

Personnel et organisation

• list_staff, y compris à qui chaque personne rend compte
• list_pto_requests

Finance et CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (écriture, nécessite mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, ce que la facturation d'un mois préparerait ; create_month_invoice_drafts (écriture, nécessite mcp:write)

Réunions

• list_meetings

Temps

• log_time_entry (écriture, nécessite mcp:write)

Invites et ressources

Au-delà des outils, le serveur propose des invites prêtes à l'emploi pour les tâches qu'un cabinet exécute (par exemple, facturer le mois, travaux en cours de fin de mois, recouvrements, qui est en surcapacité, ou un point quotidien) et des ressources qu'un assistant peut lire directement pour le contexte, comme les réunions du jour, un document de connaissances ou un projet unique. Les deux suivent les mêmes autorisations que les outils.

Les listes actuelles sont prompts/list, resources/list et resources/templates/list sur le protocole MCP en direct, et les tableaux prompts, resources et resourceTemplates dans la carte du serveur.

Sécurité

• Chaque réponse porte l'en-tête MCP-Protocol-Version négocié (2026-07-28 ou 2025-11-25).
• Chaque écriture est enregistrée dans le journal d'activité de l'entreprise avec la personne qui l'a autorisée.
• Isolation des locataires : chaque connexion est limitée à une seule entreprise ; les lectures inter-entreprises sont rejetées au niveau de la couche d'autorisations.
• Chiffrement : les données sont chiffrées au stockage (AES-256) et en transit (TLS).
• Le contenu sensible (archivé, visibilité personnelle, chiffré au niveau du champ) n'est jamais renvoyé via MCP.
• Limites de débit : 1 000 requêtes par heure et par connexion par défaut, avec des budgets négociés plus élevés pour les entreprises. Les points de terminaison de découverte anonyme et OAuth portent leurs propres limites par IP plus basses pour dissuader les abus.