khive

npx add-mcp 'https://khive.ai/v1/mcp'

Tudo acontece em khive.ai. Você faz login e gerencia sua conta em https://khive.ai em um navegador, e clientes MCP se conectam a https://khive.ai/v1/mcp.

1. Crie sua conta

O cadastro tem três etapas, nesta ordem: fazer login, criar seu workspace e manter um plano. Uma chave de API é uma quarta etapa, apenas para acesso via script. Cada uma é uma ação explícita; nenhuma delas acontece como efeito colateral da etapa anterior.

Fazer login

Abra https://khive.ai/login e faça login com um link de e-mail de uso único. Não há senha para definir.

Fazer login cria uma sessão e nada mais. Você ainda não tem um workspace, então o painel informará que sua conta não está ativa até você concluir a próxima etapa.

Crie seu workspace

Vá para API Keys no painel (https://khive.ai/dashboard/keys). Em Finish account setup, clique em Create workspace. Isso cria seu workspace: o grafo privado da sua conta e um projeto para armazenar seus dados.

Esta é a etapa que as pessoas esquecem. Ir direto para Billing antes de criar um workspace não funcionará: uma compra precisa de um workspace para ser creditada, então o painel informa que você deve concluir a configuração da conta primeiro.

Mantenha um plano

Toda conta que usa khive mantém um de três planos. Não há nível gratuito.

Plano	Mensal	Anual: 17% de desconto	Uso incluído	Teste
Start	$8	$80	1x	nenhum
Plus	$25	$250	5x Start	14 dias no mensal, cartão cadastrado
Pro	$100	$1.000	20x Start	nenhum

Cada plano inclui uma cota mensal de uso. O painel mostra quanto você já usou como uma proporção, e acima de 100% você adiciona uso extra como uma compra única (a partir de $10, válido por 500 dias), que é o que a página Billing (https://khive.ai/dashboard/billing) vende: escolha um valor, o checkout roda no Stripe, e o uso extra chega à sua conta assim que o pagamento é liquidado.

Conectar um cliente de chat (etapa 2) inicia o teste do Plus: exatamente uma tela do Stripe entre seu login e o conector ficar ativo, e o teste começa a partir daí. Start e Pro são escolhidos na página de preços. Cancele a qualquer momento; o serviço roda até o fim do período pago.

O acesso é verificado em cada chamada, nesta ordem: um plano ativo (em teste ou ativo, com período ainda não encerrado), depois uso restante (uso incluído primeiro, depois uso extra). Uma chamada recusada por qualquer uma das verificações retorna uma linha dizendo qual foi e onde gerenciar, e a lista de ferramentas não é afetada. Um plano vencido é recusado na próxima chamada.

Crie uma chave de API

De volta em API Keys, clique em Create API key. A chave é exibida uma única vez. Copie-a imediatamente e armazene-a com segurança, porque o painel não pode exibir a chave completa novamente. As chaves estão vinculadas ao seu workspace, e você pode revogar qualquer uma delas na mesma página.

Você só precisa de uma chave para acesso via script. Um cliente MCP com suporte a OAuth gerencia seus próprios tokens, conforme descrito na próxima etapa.

2. Conecte um cliente MCP

khive fala o transporte padrão MCP Streamable HTTP em:

https://khive.ai/v1/mcp

Aponte qualquer cliente MCP com suporte a OAuth (Claude Desktop, a interface de conexão do claude.ai ou seu próprio cliente construído com um SDK MCP) para essa URL. O cliente descobre os metadados OAuth em /.well-known/oauth-protected-resource/v1/mcp, redireciona você pelo mesmo login usado na etapa 1 e volta com um token de acesso com escopo na sua conta. Você não copia nem cola uma chave neste caminho. O cliente cuida da troca de tokens.

Uma vez conectado, seu cliente lista as ferramentas do khive por nome: remember e recall_memories para memória, create_record, link_records, search_records, graph_neighbors e graph_context para o grafo, add_task e list_tasks para tarefas, e o restante do catálogo. Você não as chama diretamente. Peça ao seu agente em linguagem natural e ele escolhe a ferramenta. Os exemplos abaixo mostram a ferramenta e os argumentos que ele deve acabar chamando, para que você possa verificar o que aconteceu.

Acesso via script e não interativo

Nem todo chamador consegue conduzir um redirecionamento interativo no navegador. Trabalhos de CI, scripts de backend e ambientes de agente locais precisam de uma credencial que possam manter: uma chave de API de longa duração, criada na página de API Keys na etapa 1 e enviada como Authorization: ApiKey <key> ou X-Api-Key: <key>. Uma chave de API conecta-se ao mesmo endpoint MCP que um cliente OAuth e recebe as mesmas ferramentas nomeadas; qualquer cliente MCP que possa enviar um cabeçalho de autorização fixo pode usá-la, e também um POST JSON-RPC simples para o endpoint MCP. Se você usa um cliente MCP com suporte a OAuth, não precisa de uma chave de API.

3. Dê uma memória ao seu agente

Em uma sessão, diga ao seu agente algo que vale a pena guardar:

Lembre que a API de cobrança roda na Fly na região iad, e fazemos rollback com fly releases.

O agente chama:

remember   { "content": "The billing API runs on Fly in iad; roll back with fly releases.", "memory_type": "semantic" }

e recebe o id da nova memória. Agora feche a sessão e abra uma nova, para que nada da primeira conversa esteja no contexto. Pergunte:

Como fazemos rollback da API de cobrança?

O agente chama:

recall_memories   { "query": "how to roll back the billing API" }

e responde com base na memória que armazenou, junto com sua pontuação. Memórias são registros, então uma errada pode ser corrigida com update_record ou removida com delete_record pelo id.

4. Construa um pequeno grafo e leia-o de volta

Memórias são texto livre. Quando você quer estrutura, peça ao seu agente para registrar coisas e como elas se relacionam:

Registre que billing-api é um serviço que depende de postgres-primary.

O agente chama create_record duas vezes e link_records uma vez:

create_record   { "kind": "service", "name": "billing-api", "description": "Billing API, deployed on Fly." }
create_record   { "kind": "service", "name": "postgres-primary", "description": "Primary Postgres database." }
link_records    { "source_id": "<billing-api id>", "target_id": "<postgres-primary id>", "relation": "depends_on" }

Cada create_record retorna o registro novo inteiro, incluindo seu id, e uma lista similar_existing de registros que já se parecem com ele. Antes de adicionar um duplicado, verifique essa lista. link_records verifica se a relação se encaixa nos dois tipos e recusa um par que não se encaixa.

Para ler de volta, busque por significado e depois percorra as arestas:

search_records    { "kind": "entity", "query": "which database does billing use" }
graph_neighbors   { "node_id": "billing-api" }

graph_neighbors recebe um id ou um nome e retorna cada registro vinculado com a relação e o peso de sua aresta. Quando você quer um resumo fundamentado em torno de alguns registros de uma vez, graph_context recebe entity_ids (ids ou nomes) e retorna cada um com sua vizinhança.

Gerencie sua conta

Seu plano, método de pagamento, faturas e cancelamento estão em Manage billing na página da conta (https://khive.ai/account). Perguntas: contact@khive.ai.