Integração MCP

Servidor MCP do AFFiNE: conecte ferramentas de IA à sua base de conhecimento

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.

  • Credenciais por workspace, revogáveis
  • Streamable HTTP + Bearer
  • 70K+ estrelas no GitHub

Conecte a base de conhecimento a um cliente de IA compatível

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 servidor MCP do AFFiNE em resumo

O que éO endpoint oficial do Model Context Protocol, embutido no AFFiNE Cloud e nas instâncias auto-hospedadas
EndpointPOST /api/workspaces/{workspace-id}/mcp
TransporteStreamable HTTP, sem estado
AutenticaçãoCredencial Bearer (prefixo aff_mcp_v1.), criada por cliente nas configurações do workspace
Ferramentasdoc_search / read_document; READ_WRITE: development / canary
EscopoUm workspace por credencial, respeitando suas permissões de documento
PreçoGrátis no AFFiNE Cloud e em instâncias auto-hospedadas com os recursos de IA ativados

Seu workspace ou a demonstração de conteúdo público?

Seu workspace

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}/mcp
  • doc_search
  • read_document

Conteúdo público do site

Serviç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/mcp
  • search_public_content
  • read_public_content
Public content API (English)

Conecte um cliente MCP compatível

Crie uma credencial no AFFiNE e configure o cliente no formato dele.

  1. Abra as configurações de MCP do workspace

    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.

  2. Crie uma credencial

    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.

  3. Cole a configuração no seu cliente

    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.

Conexão cliente a cliente

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.

Claude Code

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>"

Cursor

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>"
}
}
}
}

Cline

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>"
}
}
}
}

Clientes stdio locais, incluindo Claude Desktop

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 que um assistente conectado pode fazer

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.

Somente leitura

Padrão
doc_search
Busca de documentos

Busca 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_document
Ler documento

Obtém o conteúdo completo de um documento por ID, respeitando suas permissões atuais.

Leitura e escrita

Development / canary
create_document
Criar documento

Quando habilitado, cria um documento com título e corpo Markdown. Não insere blocos de banco de dados nem imagens.

update_document
Atualizar documento

Quando 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_meta
Atualizar metadados

Quando habilitado, atualiza o título do documento. A ferramenta revisada não expõe outros campos de metadados.

Restrito ao workspace

Uma credencial só alcança um workspace, com as suas permissões.

Uma credencial por cliente

Revogue o acesso de um cliente sem mexer nos outros.

Validade embutida

Toda credencial recebe uma data de validade ao ser criada.

Rotação de tokens

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.

O servidor MCP do AFFiNE na comparação

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.

AFFiNENotion MCPObsidian
Embutido, oficialSimOficial, embutido no app; credenciais nas configurações do workspaceSimServidor remoto oficial, hospedado pelo NotionNãoPlugins da comunidade ou servidores de terceiros
Auto-hospedávelSimO mesmo endpoint oficial; ative os recursos de IA na sua instânciaNãoO servidor atual é só hospedado; um antecessor open source descontinuado podia ser auto-hospedadoDependeLocalhost por padrão; remoto é por sua conta
Busca em quadros brancosSimA busca indexa o texto do canvas Edgeless e devolve localizações de elementos e quadrosNãoO Notion não tem quadro branco nativoNãoArquivos .canvas só são lidos como JSON bruto; nenhum servidor difundido busca neles
Modelo de implantaçãoCloud ou auto-hospedadoEndpoint oficial embutido no AFFiNE; no auto-hospedado é preciso ativar os recursos de IASó hospedadoO servidor oficial atual é hospedado pelo NotionLocalServidores da comunidade rodam ao lado do cofre no desktop
PreçoGrátisGrátis no Cloud e no auto-hospedado com recursos de IA ativadosNúcleo grátisBusca de apps conectados e notas de reunião exigem planos do Notion AIGrá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.

Perguntas frequentes

O que é o servidor MCP do AFFiNE?

É 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.

O servidor MCP é grátis?

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.

Uma IA conectada consegue buscar nos meus quadros brancos?

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.

Funciona com AFFiNE auto-hospedado?

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.

Dá para deixar em somente leitura?

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.

Quais ferramentas de IA conectam ao AFFiNE?

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.

Como o acesso é protegido?

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.

Coloque sua base de conhecimento para trabalhar

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