O servidor MCP de Human Design — conecte o gethumandesign à sua IA

Leve seu Human Design para a IA que você já usa. Conecte o gethumandesign uma vez, e seu assistente pode ler seu mapa, consultar as pessoas que você salvou, comparar dois mapas e dizer o que os trânsitos de hoje significam para você.

Funciona via MCP, o padrão aberto para conectar apps a assistentes de IA, então você escolhe o modelo. O que você salva na conversa vai para sua conta do gethumandesign, pronto também no app.

Funciona com

Claude
Claude Code
Gemini CLI
ChatGPT ChatGPT
Codex Codex
Grok Grok
Perplexity Perplexity
Mistral Vibe Mistral Vibe
Seu

Ou adicione o servidor você mesmo, pela URL:

https://api.gethumandesign.com/mcp

Veja em ação — ChatGPT + gethumandesign

Espere, o que é Human Design?

Human Design é um sistema de autoconhecimento que combina astrologia, I Ching, Cabala e o sistema de chakras em um único mapa chamado Bodygraph. Com base na sua data, hora e local exatos de nascimento, ele revela seu energy type, sua authority na hora de tomar decisões e seu profile de personalidade — oferecendo uma estrutura prática para entender como você funciona e se relaciona com os outros.

Saiba mais na nossa base de conhecimento de Human Design.


Configuração

Conecte sua IA favorita:

O gethumandesign está no diretório oficial de plugins do ChatGPT, então não há nada para configurar manualmente.

  1. Clique em Plugins na barra lateral do ChatGPT
  2. Pesquise por:
    gethumandesign
  3. Abra gethumandesign.com em Público e clique em + para instalar
  4. Faça login com sua conta gethumandesign quando solicitado
  5. Em um chat, mencione @gethumandesign.com — ou apenas faça uma pergunta sobre o seu Human Design e o ChatGPT escolherá as ferramentas sozinho.
Ver documentação ↗

O Codex usa o mesmo diretório de plugins do ChatGPT, pelo navegador de plugins integrado.

  1. Em uma sessão do Codex, execute:
    /plugins
  2. Digite para filtrar a lista:
    gethumandesign
  3. Selecione gethumandesign.com, pressione Enter para ver os detalhes e instale — será pedido que você faça login durante a instalação
  4. Inicie uma nova sessão do Codex para carregar as novas ferramentas

Observação: codex plugin list e codex plugin add leem apenas snapshots locais de marketplaces e não vão encontrar o gethumandesign. Use o navegador /plugins acima ou a aba de instalação manual.

Ver documentação ↗

Prefere configurar o servidor MCP você mesmo, ou o diretório de plugins não está disponível para você? Conecte-se pela URL.

Codex CLI

Execute isto no seu terminal e depois faça login:

codex mcp add gethumandesign --url https://api.gethumandesign.com/mcp
codex mcp login gethumandesign

Isso grava o seguinte em ~/.codex/config.toml, que você também pode editar manualmente:

[mcp_servers.gethumandesign]
url = "https://api.gethumandesign.com/mcp"

ChatGPT

  1. Vá para Configurações → Segurança e login e ative o Modo desenvolvedor
  2. Abra Plugins na barra lateral e clique em +
  3. Adicione um conector personalizado com a URL do servidor MCP:
    https://api.gethumandesign.com/mcp
  4. Para usar em um chat, clique em +, depois em Mais e selecione o conector.
Ver documentação ↗
  1. Clique em + na barra lateral
  2. Selecione Conectores
  3. Clique em Gerenciar conectores
  4. Clique em + → Adicionar conector personalizado
  5. Preencha os campos:
    Nome
    gethumandesign
    URL do servidor MCP remoto
    https://api.gethumandesign.com/mcp
  1. Clique em + na barra lateral
  2. Selecione Conectores
  3. Clique em Gerenciar conectores
  4. Clique em + → Adicionar conector personalizado
  5. Preencha os campos:
    Nome
    gethumandesign
    URL do servidor MCP remoto
    https://api.gethumandesign.com/mcp
Ver documentação ↗

Execute o seguinte comando no seu terminal.

claude mcp add --transport http --scope user gethumandesign https://api.gethumandesign.com/mcp
Ver documentação ↗
  1. Em gemini.google.com, clique em Settings → Connected Apps
  2. Em Custom apps, clique em Add a custom app e insira a URL do servidor MCP:
    https://api.gethumandesign.com/mcp
  3. Clique em Next e faça login com sua conta gethumandesign

O Google oferece apps personalizados apenas para contas pessoais do Google nos EUA, em inglês, com o Keep Activity ativado. Depois de adicionado na web, o app também funciona no app do Gemini para celular.

Ver documentação ↗

Execute o seguinte comando no seu terminal.

gemini mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp
Ver documentação ↗
  1. Acesse grok.com/connectors e clique em Novo conector
  2. Selecione Personalizado e insira a URL do servidor MCP:
    https://api.gethumandesign.com/mcp
  3. Faça login com sua conta gethumandesign quando solicitado

No Grok Business ou Enterprise, um administrador da equipe adiciona o servidor primeiro, no console da xAI, em Grok Business → Conectores.

Ver documentação ↗
  1. Envie isto ao seu Bot em um chat:
    Add the custom MCP server gethumandesign at https://api.gethumandesign.com/mcp
  2. Confirme o nome e a URL, depois clique em Autorizar no card e faça login com sua conta gethumandesign
  3. Digite @ em um chat para anexar o gethumandesign a uma tarefa
Ver documentação ↗

Execute o seguinte comando no seu terminal.

grok mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp
Ver documentação ↗
  1. Em perplexity.ai, abra Plugins na barra lateral (ou Personalizar → Conectores) e clique em Adicionar personalizado → Adicionar conector MCP
  2. Selecione Remoto, insira gethumandesign como nome e esta URL do servidor MCP:
    https://api.gethumandesign.com/mcp
  3. Defina Autenticação como OAuth, marque a caixa de confirmação e clique em Adicionar
  4. Clique no card do conector e faça login com sua conta gethumandesign

Conectores personalizados exigem um plano Pro, Max ou Enterprise. Em uma organização Enterprise, um administrador precisa primeiro permitir que os membros adicionem conectores personalizados.

Ver documentação ↗
  1. Em chat.mistral.ai, abra Conectores na barra lateral e clique em + Adicionar conector
  2. Mude para a aba Conector MCP personalizado, insira gethumandesign como nome do conector e esta URL do servidor:
    https://api.gethumandesign.com/mcp
  3. Clique em Conectar e faça login com sua conta gethumandesign

Somente um administrador pode adicionar um conector personalizado. Nos planos Free, Pro e Student, o dono da conta é o administrador; em um plano de equipe, peça ao seu administrador.

Ver documentação ↗

Qualquer IA que suporte servidores MCP pode se conectar usando a URL abaixo. Verifique a documentação da sua IA para saber como adicionar um servidor MCP personalizado.

https://api.gethumandesign.com/mcp

Recursos


Cartões interativos

No Claude, no ChatGPT e no Grok, as ferramentas de mapa respondem com um cartão interativo além do texto. Toque em um cartão para abrir a mesma visão no seu painel. Um mapa ou grupo calculado na hora traz um botão Salvar, para entrar na sua conta sem sair da conversa. Outros assistentes recebem os mesmos dados como texto.


Autenticação

O servidor usa OAuth 2.0. Ao conectar pela primeira vez, você será redirecionado para fazer login com sua conta gethumandesign.com (e-mail e senha, Google ou GitHub). Na mesma tela são pedidos seus dados de nascimento, para que seu chart esteja pronto já na primeira pergunta.

Plano Gratuito: 15 solicitações por mês, pessoas salvas ilimitadas.
Plano Pro: Solicitações ilimitadas, além de Color, Tone e Base, análise de grupo Penta e trânsitos, ciclos e retornos.

Gerencie seu plano e uso nas configurações.


Ferramentas

O servidor disponibiliza estas ferramentas:

Contas do plano Pro também podem fazer análise de grupo Penta e ler trânsitos:


Anotações de ferramenta

Cada ferramenta declara anotações de ferramenta MCP que informam ao seu cliente de IA que tipo de efeitos colaterais esperar. As três anotações usadas por este servidor são:

readOnlyHint
Quando true, a ferramenta apenas lê dados e nunca cria, atualiza ou exclui nada.
destructiveHint
Quando true, a ferramenta pode excluir ou sobrescrever dados de forma irreversível.
openWorldHint
Quando true, a ferramenta pode ir além do nosso próprio backend — a API externa de geocodificação que resolve os locais de nascimento, e o e-mail que o send_feedback envia para a caixa de entrada da equipe. Nossas ferramentas de escrita nunca alteram nada publicamente visível.
Ferramenta readOnly destructive openWorld Notas
calculate_chart true false true Cálculo de mapa somente leitura; chama um serviço de geocodificação externo e registra métricas de uso.
get_my_design true false true Lê seu mapa salvo do banco de dados e chama um serviço de geocodificação externo.
get_person_design true false true Lê o mapa de uma pessoa salva do banco de dados e chama um serviço de geocodificação externo.
compare_charts true false true Lê dois mapas salvos e calcula a sobreposição entre eles; pode chamar o serviço externo de geocodificação para resolver os locais de nascimento.
list_people true false false Lista pessoas salvas do banco de dados; não faz alterações.
find_people true false false Lê vários mapas salvos e responde uma pergunta sobre eles; não faz alterações.
save_person false false false Cria um novo registro de pessoa no banco de dados.
update_person false false false Sobrescreve campos de uma pessoa salva; apenas o que a ferramenta foi instruída a alterar.
set_birth_time false false false Grava a hora de nascimento de uma pessoa salva e o grau de certeza dela.
check_birth_time_stability true false true Recalcula um mapa ao longo do dia de nascimento; pode chamar o serviço externo de geocodificação.
compare_birth_times true false true Calcula mapas candidatos sem salvar nenhum deles; pode chamar o serviço externo de geocodificação.
send_feedback false false true Envia sua mensagem de feedback por e-mail para a caixa de entrada da equipe.
save_group false false false Cria ou atualiza um grupo com seus membros no banco de dados (Pro).
list_groups true false false Lista seus grupos e seus membros a partir do banco de dados (Pro).
analyse_group true false true Calcula a dinâmica de Penta de um grupo a partir dos mapas salvos; pode chamar o serviço externo de geocodificação (Pro).
get_person_transits true false false Calcula o céu atual sobre um mapa salvo; não altera nada (Pro).
get_pair_transits true false false Calcula o céu atual sobre o mapa composto de dois mapas salvos; não altera nada (Pro).
get_transits true false false Calcula a posição dos planetas a partir das efemérides incluídas no servidor; não toca em dados da conta (Pro).
rank_transits true false false Lê cada mapa salvo sobre o céu atual e os ordena; não altera nada (Pro).
next_transit true false false Busca uma data adiante nas efemérides; não altera nada (Pro).
get_cycles true false false Calcula as datas dos retornos de uma pessoa salva a partir das efemérides incluídas no servidor; não altera nada (Pro).
get_guidance true false false Retorna nossa referência fixa para ler um mapa; não acessa nenhum dado da conta.
read_skill true false false Retorna um dos nossos próprios documentos de orientação; não toca em nenhum dado da conta.

Exemplos

Pergunte sobre seu próprio design

"Qual é o meu tipo de Human Design?"

Usa get_my_design para buscar seu mapa e informar seu type, authority e profile.

Calcular um mapa para alguém

"Calcule um mapa de Human Design para alguém nascido em 10 de abril de 1985 às 14:30 em Montreal"

Usa calculate_chart para calcular e retornar o Bodygraph completo.

Salvar uma pessoa e explorar seu mapa

"Salve meu parceiro John, nascido em 5 de março de 1990 às 08:00 em Londres, depois mostre-me o mapa dele"

Usa save_person para armazenar os dados de nascimento do John, depois get_person_design para recuperar e exibir o mapa dele.

Comparar mapas

"Compare meu design com o do John — quais canais compartilhamos?"

Usa compare_charts para ler os dois mapas lado a lado e nomear os canais que vocês formam juntos.


Privacidade

Coletamos apenas o que o serviço precisa: seu e-mail para entrar e os dados de nascimento para calcular os mapas. Nunca vendemos seus dados pessoais, e seus dados de nascimento e conversas nunca são compartilhados com anunciantes. Leia nossa Política de Privacidade completa para todos os detalhes.

Suporte

Dúvidas ou problemas? Envie um e-mail para hello@gethumandesign.com.