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.
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 ».
| Ce que c'est | Le point d'accès Model Context Protocol officiel, intégré à AFFiNE Cloud et aux instances auto-hébergées |
|---|---|
| Point d'accès | POST /api/workspaces/{workspace-id}/mcp |
| Transport | Streamable HTTP, sans état |
| Authentification | Identifiant Bearer (préfixe aff_mcp_v1.), créé par client dans les réglages de l'espace de travail |
| Outils | doc_search / read_document; READ_WRITE: development / canary |
| Périmètre | Un espace de travail par identifiant, dans le respect de vos droits sur les documents |
| Prix | Gratuit sur AFFiNE Cloud et sur les instances auto-hébergées avec les fonctions IA activées |
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}/mcpdoc_searchread_documentUn 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/mcpsearch_public_contentread_public_contentCréez des identifiants dans AFFiNE, puis configurez le client dans son propre format.
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.
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.
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.
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.
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>"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>"
}
}
}
}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>"
}
}
}
}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>"
}
}
}
}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.
doc_searchRecherche 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_documentRécupère le contenu complet d'un document par ID, dans le respect de vos droits actuels.
create_documentSi 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_documentSi 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_metaSi activé, modifie le titre du document. L’outil examiné n’expose pas d’autres champs de métadonnées.
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.
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.
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| Intégré, first-party | OuiFirst-party, intégré à l'application ; identifiants créés dans les réglages de l'espace de travail | OuiServeur distant officiel, hébergé par Notion | NonPlugins communautaires ou serveurs tiers |
| Auto-hébergeable | OuiLe même point d'accès officiel ; activez les fonctions IA sur votre instance | NonServeur 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 blancs | OuiLa recherche indexe le texte du canvas Edgeless et renvoie les localisations d'éléments et de cadres | NonNotion n'a pas de tableau blanc natif | NonFichiers .canvas lisibles seulement en JSON brut ; aucun serveur répandu ne les cherche |
| Modèle de déploiement | Cloud ou auto-hébergéPoint d'accès officiel intégré à AFFiNE ; fonctions IA à activer en auto-hébergement | Hébergé uniquementLe serveur officiel actuel est hébergé par Notion | LocalLes serveurs communautaires tournent à côté du vault local de l'application de bureau |
| Prix | GratuitGratuit sur le Cloud et en auto-hébergement avec les fonctions IA activées | Cœur gratuitLa recherche d'apps connectées et les notes de réunion demandent les offres Notion AI | GratuitL'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.
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.
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.
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.
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.
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.
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.
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.
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