Servidor MCP

O que é o servidor MCP

A Next Wiki expõe um servidor Model Context Protocol (MCP), para que agentes de IA, IDEs e assistentes (Claude, seus próprios agentes, etc.) possam ler e editar a sua wiki com a sua permissão — buscando, lendo documentos e propondo ou aplicando mudanças.

Endpoint: https://SUA-WIKI/api/mcp (transporte Streamable HTTP).

Autenticação

O servidor MCP usa a mesma chave de API da API REST. Crie uma em Configurações → API (começa com nwk_) e envie-a como cabeçalho:

X-Api-Key: nwk_seu_token

Os escopos da chave valem: ferramentas de leitura exigem docs:ler, as de escrita exigem docs:escrever. Uma chave sem escopos tem acesso total (com as permissões do dono).

Conectar um cliente

Aponte seu cliente MCP para o endpoint com o cabeçalho da chave de API. Exemplo de configuração (o formato exato depende do cliente):

{
  "mcpServers": {
    "next-wiki": {
      "url": "https://SUA-WIKI/api/mcp",
      "headers": { "X-Api-Key": "nwk_seu_token" }
    }
  }
}

Ferramentas disponíveis

Ferramenta	Escopo	Parâmetros	Descrição
listar_workspaces	leitura	—	Lista os workspaces disponíveis
buscar	leitura	workspaceId, consulta	Busca documentos por texto
arvore	leitura	workspaceId	Árvore de coleções e documentos
ler_documento	leitura	documentoId	Lê o markdown de um documento
ler_comentarios	leitura	documentoId	Lista os comentários de um documento
listar_skills	leitura	workspaceId	Lista as skills de IA do workspace
listar_modelos_documento	leitura	workspaceId	Lista os modelos (tipos) de documento
criar_documento	escrita	colecaoId, titulo, conteudoMarkdown	Cria um documento numa coleção
criar_documento_do_tipo	escrita	colecaoId, tipoDocId, titulo?	Cria um documento a partir de um modelo
atualizar_documento	escrita	documentoId, conteudoMarkdown, titulo?	Substitui o conteúdo de um documento

Ferramentas de leitura exigem docs:ler; as de escrita exigem docs:escrever. Se a chave não tiver o escopo, a ferramenta retorna um erro explicando o que falta.

Veja a referência da API para toda a superfície REST.