Intégration MCP

Serveur MCP AFFiNE : connecter vos outils IA à votre base de connaissances

Le point de connexion MCP d’AFFiNE permet aux clients IA compatibles de rechercher dans les notes et le texte des tableaux blancs, puis de lire les documents. La connexion directe exige Streamable HTTP et un en-tête Bearer ; les clients stdio locaux peuvent utiliser un pont local.

  • Identifiants par espace de travail, révocables
  • Streamable HTTP + Bearer
  • 70K+ étoiles GitHub

Connecter la base de connaissances à un client IA compatible

MCP est un standard ouvert reliant les assistants IA à des outils et données. Les instances AFFiNE Cloud et auto-hébergées compatibles proposent un point de connexion par espace. L’accès direct exige Streamable HTTP et un en-tête Authorization ; un client limité à stdio nécessite un pont local comme mcp-remote.

Une fois connecté, un assistant peut lancer des recherches par mots-clés et sémantiques sur toute votre base de connaissances, tableaux blancs compris, et lire des documents entiers — avec exactement les droits que vous accordez, rien de plus. Chaque client reçoit son propre identifiant, que vous pouvez renouveler ou révoquer indépendamment : « mon IA voit mes notes » ne signifie jamais « tout, pour toujours ».

Le serveur MCP AFFiNE en un coup d'œil

Ce que c'estLe point d'accès Model Context Protocol officiel, intégré à AFFiNE Cloud et aux instances auto-hébergées
Point d'accèsPOST /api/workspaces/{workspace-id}/mcp
TransportStreamable HTTP, sans état
AuthentificationIdentifiant Bearer (préfixe aff_mcp_v1.), créé par client dans les réglages de l'espace de travail
Outilsdoc_search / read_document; READ_WRITE: development / canary
PérimètreUn espace de travail par identifiant, dans le respect de vos droits sur les documents
PrixGratuit sur AFFiNE Cloud et sur les instances auto-hébergées avec les fonctions IA activées

Connexion à votre espace ou démo de contenus publics ?

Votre espace de travail

AFFiNE Cloud ou votre instance compatible. Un identifiant Bearer propre à l’espace est requis et les droits sur les documents s’appliquent. Les outils ci-dessous sont les outils de lecture par défaut ; leur disponibilité dépend du déploiement.

https://app.affine.pro/api/workspaces/{workspace-id}/mcp
  • doc_search
  • read_document

Contenus publics du site

Un service distinct de lecture des articles et modèles publiés, sans compte ni identifiant. Il ne lit pas votre espace et ne modifie aucun document. N’envoyez jamais votre identifiant d’espace à ce point de connexion.

https://affine.pro/api/public/mcp
  • search_public_content
  • read_public_content
Public content API (English)

Connecter un client MCP compatible

Créez des identifiants dans AFFiNE, puis configurez le client dans son propre format.

  1. Ouvrir les réglages MCP de l'espace de travail

    Dans AFFiNE : Paramètres → Integrations → MCP Server. Disponible sur AFFiNE Cloud et sur les instances auto-hébergées avec les fonctions IA activées.

  2. Créer un identifiant

    Cliquez sur « Create credential », donnez-lui un libellé (un par client, par exemple « Claude Code » ou « Cursor »), puis choisissez le mode d'accès et une date d'expiration. Lecture seule est le réglage par défaut.

  3. Coller la configuration dans votre client

    Copiez le point de connexion et les identifiants depuis AFFiNE. Le jeton ne s’affiche qu’une fois. Utilisez l’exemple adapté au client ; le même JSON ne convient pas partout.

{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}

Format de connexion généré par AFFiNE, à adapter au client. Une instance auto-hébergée utilise sa propre adresse.

Connexion client par client

Vérifiez transport et authentification. Claude Code, Cursor et Cline acceptent HTTP avec un en-tête Bearer. Un écran réservé à OAuth ne peut pas utiliser ces identifiants créés manuellement. Un pont stdio exige que le client puisse lancer des processus locaux.

Claude Code

Ajoutez AFFiNE en une commande CLI, puis demandez à Claude de chercher ou lire votre espace de travail depuis n'importe quelle session.

claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"

Cursor

Ajoutez les champs URL et headers ci-dessous dans ~/.cursor/mcp.json. Utilisez les valeurs de votre espace ; les formats JSON diffèrent selon le client.

{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Cline

Ouvrez les réglages MCP de Cline et ajoutez AFFiNE comme serveur Streamable HTTP distant.

{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}

Clients stdio locaux, dont Claude Desktop

Cette configuration lance le pont tiers mcp-remote depuis un client capable de lancer des processus stdio locaux. Une version compatible de Node.js est nécessaire. Ce n’est pas un connecteur OAuth pour Claude sur le Web.

{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"--header",
"Authorization:${AFFINE_MCP_AUTH}"
],
"env": {
"AFFINE_MCP_AUTH": "Bearer <your-credential>"
}
}
}
}

Ce qu'un assistant connecté peut faire

La lecture seule est le mode par défaut. L’implémentation examinée le 26 octobre 2026 réserve les identifiants et outils d’écriture aux environnements de développement ou canary. Cela ne prouve pas leur disponibilité dans Cloud stable. Vérifiez les modes proposés et tools/list sur votre instance.

Lecture seule

Par défaut
doc_search
Recherche de documents

Recherche par mots-clés et sémantique sur les documents de l'espace de travail ; renvoie des passages bornés avec localisation de page ou de canvas. Jamais de fichiers, de blobs ni de Web.

read_document
Lire un document

Récupère le contenu complet d'un document par ID, dans le respect de vos droits actuels.

Lecture et écriture

Development / canary
create_document
Créer un document

Si activé, crée un document à partir d’un titre et d’un corps Markdown. L’insertion de blocs de base de données et d’images n’est pas prise en charge.

update_document
Mettre à jour un document

Si activé, modifie le corps Markdown par différences structurelles, sans changer le titre. Les mises à jour de blocs de base de données et d’images ne sont pas prises en charge.

update_document_meta
Mettre à jour les métadonnées

Si activé, modifie le titre du document. L’outil examiné n’expose pas d’autres champs de métadonnées.

Limité à l'espace de travail

Un identifiant n'atteint jamais qu'un espace de travail, avec vos droits.

Un identifiant par client

Révoquez l'accès d'un client sans toucher aux autres.

Expiration intégrée

Chaque identifiant reçoit une date d'expiration à sa création.

Rotation des jetons

L’ancien jeton reste valable au plus 24 heures, ou jusqu’à son expiration initiale si elle arrive avant. Une révocation peut mettre fin à l’accès plus tôt.

Le serveur MCP d'AFFiNE face aux autres

Beaucoup d'outils de notes parlent MCP désormais. La différence tient à ce que le serveur peut atteindre, où il tourne et qui le contrôle. Voici la comparaison avec les deux configurations qu'on nous demande le plus.

AFFiNENotion MCPObsidian
Intégré, first-partyOuiFirst-party, intégré à l'application ; identifiants créés dans les réglages de l'espace de travailOuiServeur distant officiel, hébergé par NotionNonPlugins communautaires ou serveurs tiers
Auto-hébergeableOuiLe même point d'accès officiel ; activez les fonctions IA sur votre instanceNonServeur actuel hébergé uniquement ; un prédécesseur open source déprécié peut s'auto-hébergerÇa dépendLocalhost par défaut, le distant est à bricoler
Recherche dans les tableaux blancsOuiLa recherche indexe le texte du canvas Edgeless et renvoie les localisations d'éléments et de cadresNonNotion n'a pas de tableau blanc natifNonFichiers .canvas lisibles seulement en JSON brut ; aucun serveur répandu ne les cherche
Modèle de déploiementCloud ou auto-hébergéPoint d'accès officiel intégré à AFFiNE ; fonctions IA à activer en auto-hébergementHébergé uniquementLe serveur officiel actuel est hébergé par NotionLocalLes serveurs communautaires tournent à côté du vault local de l'application de bureau
PrixGratuitGratuit sur le Cloud et en auto-hébergement avec les fonctions IA activéesCœur gratuitLa recherche d'apps connectées et les notes de réunion demandent les offres Notion AIGratuitL'application comme les serveurs communautaires

Comparaison fondée sur les capacités publiquement documentées, en août 2026.

Les serveurs MCP d'Obsidian fondés sur l'API REST exigent que l'application de bureau tourne. La CLI d'Obsidian (2026) est une surface d'automatisation officielle, mais ce n'est pas du MCP.

Questions fréquentes

Qu'est-ce que le serveur MCP d'AFFiNE ?

C'est le point d'accès Model Context Protocol officiel intégré à AFFiNE. Il permet aux assistants IA comme Claude, Cursor et Cline de chercher et lire les documents d'un de vos espaces de travail AFFiNE via une connexion HTTP standard et authentifiée, avec des identifiants que vous créez et contrôlez dans les réglages de l'espace de travail.

Le serveur MCP est-il gratuit ?

Oui. Il est gratuit sur AFFiNE Cloud comme sur les instances auto-hébergées avec les fonctions IA activées. La connexion elle-même n'entraîne aucun coût.

Une IA connectée peut-elle chercher dans mes tableaux blancs ?

Oui. doc_search couvre les documents page et les tableaux blancs Edgeless : le texte du canvas est indexé, et les résultats portent des localisations de bloc, d'élément ou de cadre — l'assistant peut montrer où exactement se trouve la réponse sur un tableau blanc. La lecture intégrale renvoie le contenu des pages ; le contenu des tableaux blancs remonte par la recherche. La plupart des serveurs MCP de prise de notes ne voient que du texte.

Fonctionne-t-il avec AFFiNE auto-hébergé ?

Oui. Le point d'accès MCP officiel est disponible sur les instances AFFiNE auto-hébergées : il vit alors sur l'adresse de votre propre serveur, et la configuration est identique (Paramètres → Integrations → MCP Server). Les fonctions IA doivent être activées sur l'instance.

Peut-on rester en lecture seule ?

La lecture seule est le mode par défaut. L’implémentation examinée le 26 octobre 2026 réserve les identifiants et outils d’écriture aux environnements de développement ou canary. Cela ne prouve pas leur disponibilité dans Cloud stable. Vérifiez les modes proposés et tools/list sur votre instance.

Quels outils IA peuvent se connecter à AFFiNE ?

Vérifiez transport et authentification. Claude Code, Cursor et Cline acceptent HTTP avec un en-tête Bearer. Un écran réservé à OAuth ne peut pas utiliser ces identifiants créés manuellement. Un pont stdio exige que le client puisse lancer des processus locaux.

Comment l'accès est-il sécurisé ?

Un identifiant n'atteint jamais qu'un espace de travail, avec vos droits. Révoquez l'accès d'un client sans toucher aux autres. Chaque identifiant reçoit une date d'expiration à sa création. L’ancien jeton reste valable au plus 24 heures, ou jusqu’à son expiration initiale si elle arrive avant. Une révocation peut mettre fin à l’accès plus tôt.

Mettez votre base de connaissances au travail

Créez un identifiant dans les réglages de votre espace de travail : vos outils IA commencent à répondre à partir de vos propres notes dès aujourd'hui.

Dernière mise à jour: 26 octobre 2026