arkerah

npx add-mcp 'https://app.arkerah.com/api/mcp'

Conecte seu assistente de IA ao arkerah

O servidor MCP arkerah permite que um assistente de IA que fale o Model Context Protocol, como o Claude, trabalhe com sua própria conta arkerah. Ele pode ler seus empregos ranqueados, um emprego por completo, por que alguns empregos não são mostrados a você e o que o arkerah sabe sobre você. Ele pode sugerir três mudanças, e nada muda até você confirmar no arkerah.

O que é o servidor MCP arkerah?

É um endereço, https://app.arkerah.com/api/mcp, que fala o Model Context Protocol via Streamable HTTP. Um cliente que possa entrar com OAuth ou enviar um token de portador pode se conectar a ele: claude.ai, Claude Desktop e Claude Code são aqueles para os quais foi construído.

Cada ferramenta chama a mesma função que o aplicativo arkerah chama. Seu assistente vê a lista que o mapa mostra a você, ranqueada da mesma forma e com seus próprios filtros aplicados, e nada sobre qualquer outra pessoa.

O servidor não guarda nada entre duas chamadas e lê apenas um token de portador. Um cookie de navegador enviado a ele é ignorado, então uma página da web não pode usar sua sessão conectada para acessá-lo. O que seu assistente lê sai do arkerah e vai para o provedor desse assistente, sob seus próprios termos.

O que seu assistente pode ler?

Cinco ferramentas leem, e nenhuma delas muda nada.

Ferramenta	O que recebe	O que retorna
search_jobs	Opcionalmente, um local (uma cidade, uma província ou um código de país, como NL) e um limite, de até 50	Seus empregos ranqueados: título, empresa, local, classificação, data de publicação e o link do LinkedIn
job_details	O id search_jobs retornado	Um emprego por completo: o texto do anúncio, seus requisitos, os idiomas solicitados, salário se informado, nível e link
why_not	Uma pergunta simples, como empregos de vendas em Amsterdã	Empregos que não são mostrados a você e quais dos seus próprios filtros impedem cada um
what_you_know_about_me	Nada	Todos os fatos ativos que o arkerah tem sobre você, por tópico, e se você os informou, se foram lidos de um documento ou se foram inferidos
count_jobs	Um nível (país, região ou cidade), opcionalmente dentro de um local	Quantos dos seus empregos existem por local: os números no mapa

Olhar não marca um emprego como visto, não reconstrói como você é correspondido e não chama nenhum modelo de linguagem. As únicas coisas que uma chamada escreve sobre você são quando o token foi usado pela última vez e quantas chamadas ele fez nesta hora.

O que ele pode sugerir e como você confirma?

• hide_company: parar de mostrar empregos na empresa de um emprego que ele nomeia.
• show_company_again: mostrar uma empresa que você ocultou.
• correct_fact: corrigir algo que o arkerah tem sobre você ou adicionar algo novo.

Nenhuma delas muda nada por si só. Cada uma coloca um cartão no seu chat de suporte do arkerah que abre com "Seu assistente de IA pediu isto" e nomeia exatamente o que mudaria. Abra o chat de suporte, o ícone de busca no canto superior direito, e pressione Salvar em um fato ou Sim, faça em uma ação. Não agora recusa. Um cartão pode ser respondido uma vez.

Por que não confiar no prompt de aprovação do próprio assistente? Porque ele pode ser configurado para sempre permitir, mostra os argumentos do modelo em vez da mudança em palavras, e é o assistente pedindo para chamar o arkerah, não o arkerah perguntando a você sobre seu próprio registro. O prompt ainda ajuda como um primeiro filtro. Só não é o seu "sim".

correct_fact faz uma chamada de modelo para ler o que recebeu, a mesma chamada que o chat de suporte faz, e compartilha o limite do chat de 60 por hora, então um assistente não pode gastar mais do que você digitando poderia.

O que ele nunca pode fazer?

• Excluir sua conta, mudar sua senha ou seu e-mail, ou gerar um CV. Não há ferramenta para nenhum deles, e uma chamada com um desses nomes é recusada.
• Candidatar-se a um emprego. O arkerah nunca se candidata por você.
• Ler a conta de qualquer outra pessoa. Cada token pertence a uma conta, e cada ferramenta opera como essa conta.
• Mudar qualquer coisa por meio de uma ferramenta de leitura.
• Fazer mais de 300 chamadas por hora em um token ou um aplicativo conectado. Além disso, é informado para tentar novamente mais tarde, com um tempo de espera.

Como você conecta o Claude no claude.ai ou no Claude Desktop?

1. Abra Configurações, depois Conectores, depois Adicionar conector personalizado.
2. Cole o endereço https://app.arkerah.com/api/mcp. Deixe o ID do cliente e o segredo do cliente vazios.
3. O Claude encontra o login do arkerah por conta própria e abre a tela de consentimento do arkerah. Se você estiver desconectado, entre com seu e-mail ou com o Google primeiro, e você volta para a mesma tela.
4. Leia o que a tela diz que o aplicativo pode fazer e pressione Permitir ou Não, obrigado.

Isso é tudo. O aplicativo agora aparece no arkerah em Configurações, Conectar um assistente de IA, Aplicativos conectados, onde você pode desconectá-lo a qualquer momento.

Como você conecta o Claude Code ou outro cliente local?

Crie um token pessoal no arkerah: abra Configurações, depois Conectar um assistente de IA, dê um nome ao token e pressione Criar um token. Ele é mostrado uma vez, então copie-o nesse momento. As Configurações imprimem o comando exato com seu token. Para o Claude Code, é:

claude mcp add --transport http arkerah https://app.arkerah.com/api/mcp \
  --header "Authorization: Bearer ark_pat_YOUR_TOKEN"

Qualquer outro cliente que possa definir um cabeçalho funciona da mesma forma: envie o token como Authorization: Bearer. Em um arquivo .mcp.json, fica assim:

{
  "mcpServers": {
    "arkerah": {
      "type": "http",
      "url": "https://app.arkerah.com/api/mcp",
      "headers": { "Authorization": "Bearer ark_pat_YOUR_TOKEN" }
    }
  }
}

O Claude Code pode entrar com OAuth em vez disso: execute o mesmo comando sem o cabeçalho e digite /mcp para entrar. Você pode manter até cinco tokens pessoais ao mesmo tempo.

Como funcionam OAuth e consentimento?

O arkerah é seu próprio servidor de login, seguindo a especificação de autorização do MCP. Quando um cliente chama sem um token válido, o arkerah responde 401 e aponta para um documento que diz onde entrar. O cliente se registra e envia você para a tela de consentimento do arkerah com um desafio PKCE de uso único, então um código que ele recebe é inútil para qualquer outra pessoa.

A tela de consentimento mostra o nome do aplicativo, sua conta, para onde a resposta vai e o que cada permissão permite. Permitir envia ao aplicativo um código que funciona uma vez e dura cinco minutos. O aplicativo o troca por um token de acesso que dura uma hora e um token de atualização que dura 30 dias.

Permissão	O que a tela de consentimento diz
ler	Leia seus empregos ranqueados, um emprego por completo, por que empregos não são mostrados a você e o que o arkerah sabe sobre você.
propor	Sugira uma mudança, como ocultar uma empresa ou corrigir algo sobre você. Nada muda até você confirmar no chat de suporte do arkerah.

Os tokens são armazenados apenas como um hash de mão única. Um token de atualização funciona uma vez, e se um for apresentado duas vezes, o arkerah encerra toda a conexão, porque significa que duas partes o possuem. Cada token funciona apenas no endereço MCP do próprio arkerah. Um aplicativo que pede apenas leitura não recebe as três ferramentas de sugestão.

Comparado	OAuth, um conector personalizado	Um token pessoal
Feito para	claude.ai e Claude Desktop	Claude Code ou qualquer cliente que possa enviar um cabeçalho
Como você obtém	Entre e pressione Permitir	Configurações, Criar um token, mostrado uma vez
Quanto dura	Uma hora, renovado por um token de atualização de 30 dias enquanto em uso	Até você revogá-lo
O que pode fazer	Ler e propor, ou apenas ler se o aplicativo pedir	Ler e propor
Limite	300 chamadas por hora por aplicativo conectado	300 chamadas por hora por token, no máximo cinco tokens
Como encerrar	Desconectar	Revogar

Como você desconecta um assistente?

No arkerah, abra Configurações, depois Conectar um assistente de IA. Cada aplicativo que você conectou com OAuth está listado em Aplicativos conectados, com o dia em que conectou, quando foi usado pela última vez e se pode sugerir mudanças. Desconectar encerra todo token que esse aplicativo possui, na próxima chamada.

Cada token pessoal é listado com seu nome, seus últimos quatro caracteres e quando foi usado pela última vez. Revogar o encerra, e a próxima chamada com ele é recusada.

Excluir sua conta exclui todo token e toda conexão junto. Sua exportação lista os aplicativos e tokens que você tinha, nunca os próprios tokens.

O que ele ainda não faz?

• search_jobs retorna até 50 empregos por vez, sem paginação. Restrinja por local para ver mais.
• Um aplicativo não pode revogar seu próprio token pela API. Você o desconecta nas Configurações.
• Um cartão no chat de suporte diz "Seu assistente de IA pediu isto", não qual assistente.

Perguntas

Quais assistentes podem se conectar?

Qualquer cliente MCP que fale Streamable HTTP e possa entrar com OAuth ou enviar um token de portador. claude.ai, Claude Desktop e Claude Code são os clientes para os quais foi construído.

Meu assistente vê dados de outras pessoas?

Não. Cada token pertence a uma conta, e cada ferramenta opera como essa conta.

Meu assistente pode mudar meu perfil sem me perguntar?

Não. Uma sugestão é um cartão no seu chat de suporte, e apenas seu Salvar ou Sim, faça faz a mudança.

Conectar um assistente custa algo?

Não. O arkerah é gratuito enquanto está em acesso antecipado, e isso inclui conectar um assistente.

Um assistente lendo meus empregos os marca como vistos?

Não. As ferramentas de leitura não mudam nada na sua lista, incluindo o que conta como novo.

O que acontece com uma conexão se eu excluir minha conta?

Ela vai junto com a conta, imediatamente, junto com todo token pessoal.