KnowMapped MCP

Conecte um cliente de IA ao KnowMapped.

Com o Professional, conecte um cliente de IA compatível à sua conta KnowMapped. Peça para ele encontrar um mapa, criar um, editar conceitos e relacionamentos, ou publicar um snapshot público concluído.

Encontre, crie, edite e publique mapas por meio de conversa.

Por meio do MCP, um cliente de IA pode ler e alterar conceitos individuais, conexões, detalhes do mapa e layouts. Ele usa as permissões da sua conta KnowMapped conectada.

01

Encontre e recupere

Pesquise os mapas disponíveis para sua conta e solicite representações completas, compactas ou resumidas.

02

Crie e estenda

Prepare um mapa, revise a cobrança de um crédito e confirme a criação. Acrescente descobertas a mapas existentes.

03

Publique e atualize

Torne mapas públicos ou privados, publique edições concluídas como snapshots públicos e verifique o status de entrega.

04

Edite e organize

Adicione, revise, conecte, remova e organize o conteúdo do mapa com validação antes de aplicar as alterações.

1. 01

   Configure o servidor de recursos

   Configure um servidor HTTP Streamable remoto com https://mcp.knowmapped.com/mcp. Operações autenticadas usam uma resposta 401 e desafio WWW-Authenticate quando a autorização é necessária. A descoberta de ferramentas pode estar disponível antes do login.
2. 02

   Resolva os metadados OAuth

   Siga o desafio até os metadados do recurso protegido, resolva seu servidor de autorização e leia os metadados do servidor de autorização. É aqui que o cliente aprende os endpoints, escopos, método PKCE e opções de registro.
3. 03
4. 04

   Autorize com PKCE

   Gere um verificador e desafio PKCE S256, abra a solicitação de autorização no navegador, faça login e aprove os escopos de mapa solicitados. As credenciais permanecem no fluxo do navegador KnowMapped.
5. 05

   Inicialize e carregue ferramentas

   Troque o código de autorização com o verificador e a vinculação de recurso, envie o token de portador para https://mcp.knowmapped.com/mcp, e então execute a inicialização MCP e tools/list. Atualize as ferramentas do cliente ou inicie uma nova conversa após conectar.

Use KnowMapped com ChatGPT ou Codex.

ChatGPT

Adicione um aplicativo personalizado.

Abra os Plugins do ChatGPT, selecione o botão de adição e depois Adicionar servidor MCP personalizado. Insira https://mcp.knowmapped.com/mcp e escolha autenticação OAuth. Conclua o fluxo de consentimento no navegador do KnowMapped, instale o plugin resultante e invoque-o em um novo chat. Atualize suas ferramentas após uma atualização do servidor.

Leia o guia de plugins MCP da OpenAI

Codex

Adicione um servidor MCP remoto.

Registre o endpoint HTTP Streamable e execute o comando de login separado para que o Codex possa concluir o fluxo OAuth baseado no navegador e armazenar em cache as credenciais resultantes.

codex mcp add knowmapped --url https://mcp.knowmapped.com/mcp
codex mcp login knowmapped
codex mcp list

Leia o guia MCP do Codex da OpenAI

As permissões da sua conta ainda se aplicam.

Cada solicitação é limitada pelo acesso existente a mapas da conta conectada. Um link público não concede permissão de edição, e um cliente não pode contornar controles de propriedade ou compartilhamento.

A criação de mapas via MCP requer Professional ou um teste Professional ativo. Cada mapa criado com sucesso usa 1 crédito de geração. A verificação prévia mostra o custo e o saldo restante; o cliente deve pedir que você confirme antes de cobrar. Validação com falha não usa créditos. Ler, editar, verificar status de publicação e publicar mapas existentes não usam créditos de criação.

Edição e publicação têm permissões separadas. Aprove maps:write para edições de conteúdo e maps:publish para snapshots públicos e alterações de visibilidade. Conexões existentes devem solicitar novo consentimento para obter acesso de publicação.

Conexões não têm expiração programada de credencial de atualização na implantação padrão. Clientes renovam tokens de acesso de curta duração automaticamente e devem salvar cada credencial de atualização rotacionada. Revogação, alterações de senha, restrições de conta ou perda de credenciais de atualização ainda podem exigir reconexão.

Desconecte a integração do seu cliente para remover sua conexão local. Você também pode revogar o acesso OAuth do KnowMapped quando precisar invalidar uma autorização existente.

Publique quando as edições estiverem prontas.

Peça ao agente para terminar a edição e depois publicar. Edições comuns deixam o snapshot público existente inalterado. A primeira publicação usa set_knowmapped_map_visibility e requer sua permissão explícita e confirmação de que você tem o direito de publicar.

Para um mapa já público, publish_knowmapped_map substitui o snapshot público pelo rascunho concluído. O KnowMapped gera sua prévia pública e aplica as mesmas moderação, restrições, bloqueios e permissões da publicação no navegador.

Ambas as ações precisam do expected_revision atual e de um idempotency_key único de 1–200 caracteres. Após um tempo limite, tente novamente com a mesma chave e argumentos idênticos. Uma solicitação alterada precisa de uma nova chave. Resultados confirmados podem ser recuperados por 30 dias sem repetir a publicação ou desfazer alterações posteriores de visibilidade.

Use get_knowmapped_publication_status para verificar a revisão publicada, moderação e entrega. Um snapshot salvo pode ainda estar aguardando entrega, e uma revisão pendente não é uma publicação bem-sucedida. Diferenças de revisão significam que o conteúdo pode ter mudado; alterações operacionais também avançam revisões.

Para remover o acesso público, peça ao agente para tornar o mapa privado. Isso remove o snapshot público, desativa a visualização ao vivo e enfileira a exclusão da página pública e da prévia. Cópias baixadas anteriormente permanecem fora do controle do KnowMapped.

Descoberta, autorização e ferramentas.

O servidor segue as convenções de descoberta MCP Streamable HTTP e OAuth. Os clientes devem começar pelo endpoint MCP em vez de configurar endpoints de autorização manualmente.

Descoberta

Endpoint MCP

https://mcp.knowmapped.com/mcp

Recurso protegido

https://mcp.knowmapped.com/.well-known/oauth-protected-resource/mcp

Servidor de autorização

https://app.knowmapped.com

OAuth

Concessão

Código de autorização com PKCE S256

Registro de cliente

Documentos de metadados de ID do cliente, com fallback de Registro Dinâmico de Cliente

Recurso

https://mcp.knowmapped.com/mcp

Escopo	Finalidade
maps:read	Pesquisar e recuperar mapas disponíveis para a conta conectada.
maps:create	Verificação prévia, confirmação, criação e recuperação de resultados de criação de mapas.
maps:write	Validar e aplicar edições em mapas onde a conta tem acesso de edição.
maps:publish	Tornar mapas editáveis públicos ou privados, publicar snapshots públicos e verificar o status de publicação. Não concede edição de conteúdo.

Leia resource://knowmapped/capabilities para limites, custos de criação e o contrato atual de ferramentas. A recuperação suporta valores independentes de node_offset e edge_offset, com page_size até 200. Solicitações de resumo carregam contagens sem conteúdo de grafo; solicitações paginadas carregam apenas as linhas solicitadas. Compare revisões entre páginas e reinicie se elas mudarem.

Ferramentas atuais

search_knowmapped_maps

Pesquise a biblioteca de mapas autorizada.

get_knowmapped_map

Recupere páginas completas ou compactas, ou contagens resumidas sem grafo.

get_knowmapped_map_adjacency

Inspecione a vizinhança de um conceito por ID ou rótulo único exato.

get_knowmapped_layout_summary

Inspecione limites de layout e estatísticas de sobreposição.

preflight_knowmapped_map_creation

Verifique elegibilidade, créditos e um rascunho de grafo retido.

create_knowmapped_map

Valide ou prepare a criação; o uso de crédito requer confirmação explícita.

confirm_knowmapped_map_creation

Confirme um rascunho retido e liquide sua cobrança de um crédito de criação.

get_knowmapped_map_creation_result

Recupere um resultado de criação após uma resposta perdida.

get_knowmapped_update_schema

Obtenha o esquema de operação autoritativo antes de construir edições.

update_knowmapped_map

Valide ou aplique um patch de grafo atômico e seguro para revisão.

set_knowmapped_map_visibility

Torne um mapa público ou privado; a primeira publicação cria um snapshot.

publish_knowmapped_map

Publique ou republique edições concluídas em um mapa já público.

get_knowmapped_publication_status

Verifique revisão de snapshot, moderação e entrega sem baixar o grafo.

Comece com a atualização de ferramentas do cliente.

Ferramentas não aparecem

Atualize as ferramentas da integração e inicie uma nova conversa. Uma conversa existente pode reter a lista de ferramentas que recebeu quando começou.

O login não abre

Desconecte e reconecte o KnowMapped no cliente. Confirme que o cliente suporta OAuth para servidores MCP remotos.

Um mapa não pode ser alterado

Confirme que a conexão tem maps:write e que sua conta pode editar o mapa. Recupere sua revisão atual e verifique se está bloqueado.

A publicação está indisponível

Solicite maps:publish e aprove novo consentimento. Atualize a descoberta de ferramentas. Sua conta ainda precisa de acesso de edição; moderação ou restrições de publicação podem impedir a publicação.

Uma resposta de publicação foi perdida

Tente novamente a solicitação idêntica com sua chave original e depois verifique o status de publicação. Use uma nova chave apenas para uma nova solicitação.

Uma conexão precisa de login novamente

Verifique se o acesso foi revogado ou se o cliente perdeu uma credencial de atualização rotacionada. Credenciais de atualização não têm expiração programada na implantação padrão, mas os clientes devem renová-las e salvá-las corretamente.