O endpoint MCP do AFFiNE permite que clientes de IA compatíveis pesquisem notas e texto dos quadros e leiam documentos. Conexões diretas exigem Streamable HTTP e cabeçalho Bearer; clientes com stdio local podem usar uma ponte local.
MCP é um padrão aberto para conectar assistentes a ferramentas e dados. Instâncias compatíveis do AFFiNE Cloud e auto-hospedadas incluem um endpoint por workspace. A conexão direta exige Streamable HTTP e cabeçalho Authorization. Clientes apenas stdio precisam de uma ponte local como mcp-remote.
Conectado, um assistente executa buscas por palavra-chave e semânticas em toda a sua base de conhecimento, quadros brancos incluídos, e lê documentos inteiros — com exatamente as permissões que você concede, nada além. Cada cliente recebe a própria credencial, que você pode trocar ou revogar de forma independente: «minha IA vê minhas notas» nunca precisa virar «tudo, para sempre».
| O que é | O endpoint oficial do Model Context Protocol, embutido no AFFiNE Cloud e nas instâncias auto-hospedadas |
|---|---|
| Endpoint | POST /api/workspaces/{workspace-id}/mcp |
| Transporte | Streamable HTTP, sem estado |
| Autenticação | Credencial Bearer (prefixo aff_mcp_v1.), criada por cliente nas configurações do workspace |
| Ferramentas | doc_search / read_document; READ_WRITE: development / canary |
| Escopo | Um workspace por credencial, respeitando suas permissões de documento |
| Preço | Grátis no AFFiNE Cloud e em instâncias auto-hospedadas com os recursos de IA ativados |
AFFiNE Cloud ou sua instância compatível. Exige uma credencial Bearer do workspace e respeita permissões de documentos. Abaixo estão as ferramentas padrão de leitura; a disponibilidade depende da implantação.
https://app.affine.pro/api/workspaces/{workspace-id}/mcpdoc_searchread_documentServiço separado de leitura de artigos e modelos publicados, sem conta ou credencial. Não acessa seu workspace nem escreve documentos. Nunca envie sua credencial do workspace a esse endpoint.
https://affine.pro/api/public/mcpsearch_public_contentread_public_contentCrie uma credencial no AFFiNE e configure o cliente no formato dele.
No AFFiNE, vá em Configurações → Integrations → MCP Server. Funciona no AFFiNE Cloud e em instâncias auto-hospedadas com os recursos de IA ativados.
Clique em 'Create credential', dê um rótulo (um por cliente, por exemplo 'Claude Code' ou 'Cursor') e escolha o modo de acesso e a validade. Somente leitura é o padrão.
Copie o endpoint e a credencial do AFFiNE. O token aparece uma única vez. Use o exemplo do seu cliente; nem todos aceitam o mesmo JSON.
{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}
Formato gerado pelo AFFiNE; adapte ao cliente. Instâncias auto-hospedadas usam seu próprio endereço.
Confira transporte e autenticação. Claude Code, Cursor e Cline aceitam HTTP com cabeçalho Bearer. Uma tela que só aceita OAuth não usa essa credencial criada manualmente. A ponte stdio exige que o cliente possa iniciar processos locais.
Adicione o AFFiNE com um comando de CLI e peça ao Claude para buscar ou ler seu workspace em qualquer sessão.
claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"Adicione URL e headers do exemplo a ~/.cursor/mcp.json. Use os valores copiados do seu workspace; os formatos JSON variam entre clientes.
{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}Abra as configurações de MCP do Cline e adicione o AFFiNE como servidor Streamable HTTP remoto.
{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}Esta configuração executa a ponte de terceiros mcp-remote em um cliente capaz de iniciar processos stdio locais. É necessário um Node.js compatível. Não é um conector OAuth do Claude na 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>"
}
}
}
}O padrão é somente leitura. A implementação revisada em 26 de outubro de 2026 limita credenciais e ferramentas de escrita a ambientes de desenvolvimento ou canary. Isso não comprova disponibilidade no Cloud estável. Confira o modo de acesso e tools/list da sua instância.
doc_searchBusca por palavra-chave e semântica nos documentos do workspace; devolve trechos delimitados com localização de página ou canvas. Nunca arquivos, blobs ou a web.
read_documentObtém o conteúdo completo de um documento por ID, respeitando suas permissões atuais.
create_documentQuando habilitado, cria um documento com título e corpo Markdown. Não insere blocos de banco de dados nem imagens.
update_documentQuando habilitado, atualiza o corpo Markdown por diferenças estruturais, sem mudar o título. Não atualiza blocos de banco de dados nem imagens.
update_document_metaQuando habilitado, atualiza o título do documento. A ferramenta revisada não expõe outros campos de metadados.
Uma credencial só alcança um workspace, com as suas permissões.
Revogue o acesso de um cliente sem mexer nos outros.
Toda credencial recebe uma data de validade ao ser criada.
O token antigo vale por até 24 horas ou até a expiração original, o que ocorrer primeiro. A revogação pode encerrar o acesso antes.
Muitas ferramentas de notas já falam MCP. A diferença está no que o servidor alcança, onde roda e quem controla. Veja como o servidor embutido do AFFiNE se compara com as duas configurações mais perguntadas.
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| Embutido, oficial | SimOficial, embutido no app; credenciais nas configurações do workspace | SimServidor remoto oficial, hospedado pelo Notion | NãoPlugins da comunidade ou servidores de terceiros |
| Auto-hospedável | SimO mesmo endpoint oficial; ative os recursos de IA na sua instância | NãoO servidor atual é só hospedado; um antecessor open source descontinuado podia ser auto-hospedado | DependeLocalhost por padrão; remoto é por sua conta |
| Busca em quadros brancos | SimA busca indexa o texto do canvas Edgeless e devolve localizações de elementos e quadros | NãoO Notion não tem quadro branco nativo | NãoArquivos .canvas só são lidos como JSON bruto; nenhum servidor difundido busca neles |
| Modelo de implantação | Cloud ou auto-hospedadoEndpoint oficial embutido no AFFiNE; no auto-hospedado é preciso ativar os recursos de IA | Só hospedadoO servidor oficial atual é hospedado pelo Notion | LocalServidores da comunidade rodam ao lado do cofre no desktop |
| Preço | GrátisGrátis no Cloud e no auto-hospedado com recursos de IA ativados | Núcleo grátisBusca de apps conectados e notas de reunião exigem planos do Notion AI | GrátisTanto o app quanto os servidores da comunidade |
Comparação baseada em capacidades documentadas publicamente, em agosto de 2026.
Os servidores MCP do Obsidian baseados na API REST exigem o aplicativo de desktop em execução. A CLI do Obsidian (2026) é uma interface oficial de automação, mas não é MCP.
É o endpoint oficial do Model Context Protocol embutido no AFFiNE. Ele permite que assistentes de IA como Claude, Cursor e Cline busquem e leiam os documentos de um dos seus workspaces do AFFiNE por uma conexão HTTP padrão e autenticada, com credenciais que você cria e controla nas configurações do workspace.
Sim. É grátis no AFFiNE Cloud e nas instâncias auto-hospedadas com os recursos de IA ativados. A conexão em si não tem custo adicional.
Sim. O doc_search cobre documentos de página e quadros brancos Edgeless igualmente: o texto do canvas é indexado e os resultados carregam localizações de bloco, elemento ou quadro — o assistente aponta em que parte do quadro branco está a resposta. A leitura completa devolve conteúdo de página; o conteúdo dos quadros brancos aparece pela busca. A maioria dos servidores MCP de notas só enxerga texto puro.
Sim. O endpoint MCP oficial está disponível nas instâncias auto-hospedadas do AFFiNE: ele fica no endereço do seu próprio servidor e a configuração é idêntica (Configurações → Integrations → MCP Server). Os recursos de IA precisam estar ativados na instância.
O padrão é somente leitura. A implementação revisada em 26 de outubro de 2026 limita credenciais e ferramentas de escrita a ambientes de desenvolvimento ou canary. Isso não comprova disponibilidade no Cloud estável. Confira o modo de acesso e tools/list da sua instância.
Confira transporte e autenticação. Claude Code, Cursor e Cline aceitam HTTP com cabeçalho Bearer. Uma tela que só aceita OAuth não usa essa credencial criada manualmente. A ponte stdio exige que o cliente possa iniciar processos locais.
Uma credencial só alcança um workspace, com as suas permissões. Revogue o acesso de um cliente sem mexer nos outros. Toda credencial recebe uma data de validade ao ser criada. O token antigo vale por até 24 horas ou até a expiração original, o que ocorrer primeiro. A revogação pode encerrar o acesso antes.
Crie uma credencial nas configurações do workspace e suas ferramentas de IA começam hoje a responder a partir das suas próprias notas.
Última atualização: 26 de outubro de 2026