Name.com

Gerencie domínios usando a API do Name.com.

Documentação

Servidor MCP do name.com

Um servidor Model Context Protocol (MCP) que fornece acesso à API completa do name.com para operações de gerenciamento de domínios. Este servidor gera automaticamente ferramentas a partir da especificação OpenAPI do name.com, dando a assistentes de IA acesso a todas as funções da API do name.com, incluindo registro de domínios, gerenciamento de DNS, transferências, encaminhamento de e-mail, encaminhamento de URL e muito mais.

⚠️ Ferramenta Experimental: Este servidor MCP é atualmente experimental e usa por padrão o ambiente de teste do name.com (mcp.dev.name.com), que requer credenciais do ambiente de teste. Embora você possa configurá-lo para usar o ambiente de produção, recomendamos usar o ambiente de teste para experimentação inicial.

Este servidor MCP funciona com qualquer ferramenta de IA que suporte o Model Context Protocol (MCP). Você pode usá-lo para tarefas de gerenciamento de domínios por meio de conversa natural com seu assistente de IA preferido. O servidor cria dinamicamente ferramentas para cada endpoint disponível da API do name.com, então você tem acesso a toda a gama de recursos de gerenciamento de domínios.

Recursos

🔄 Acesso Completo à API: Cria dinamicamente ferramentas para cada endpoint da API do name.com
🛡️ Autenticação Segura: Usa credenciais da API do name.com com autenticação adequada
🔧 Integração Fácil: Configuração simples com ferramentas de IA populares
🧪 Teste Seguro: Usa por padrão o ambiente de teste para experimentação
🤖 Design Focado em IA: Construído especificamente para interação em linguagem natural via MCP
🆘 Ajuda Integrada: Peça ajuda, solução de problemas e links de documentação ao seu assistente de IA

Início Rápido

Pré-requisitos

Uma ferramenta de IA que suporte MCP:
- Cursor
- Claude Desktop
- Outras ferramentas compatíveis com MCP (consulte a documentação delas)
Conta no name.com com credenciais de API (cadastre-se gratuitamente | ajuda para obter credenciais)

Configuração

Basta copiar e colar esta configuração no arquivo de configuração MCP da sua ferramenta de IA. Isso usa o ambiente de teste do name.com por padrão, que é perfeito para testar com segurança.

{
  "mcpServers": {
    "namecom": {
      "command": "npx",
      "args": ["-y", "namecom-mcp@latest"],
      "env": {
        "NAME_USERNAME": "your-test-username",  // Replace with your test username
        "NAME_TOKEN": "your-test-token"         // Replace with your test api token
      }
    }
  }
}

Importante: Substitua your-test-username e your-test-token pelas suas credenciais reais do ambiente de teste do name.com. Não sabe onde obtê-las? Veja obtendo credenciais.

Para ambiente de produção (avançado), basta adicionar a URL da API:

{
  "mcpServers": {
    "namecom": {
      "command": "npx",
      "args": ["-y", "namecom-mcp@latest"],
      "env": {
        "NAME_USERNAME": "your-prod-username",  // Replace with your production username
        "NAME_TOKEN": "your-prod-token",        // Replace with your production api token
        "NAME_API_URL": "https://mcp.name.com"
      }
    }
  }
}

Importante: Substitua your-prod-username e your-prod-token pelas suas credenciais reais de produção. Elas afetam sua conta real no name.com e podem gerar cobranças!

⚠️ Aviso de Produção: Isso afetará sua conta real no name.com e pode gerar cobranças. Veja Detalhes do Ambiente para requisitos de credenciais.

Como adicionar esta configuração à sua ferramenta:

Cursor:

Abra o Cursor → Pressione Cmd+Shift+J (Mac) ou Ctrl+Shift+J (Windows)
Vá para Ferramentas e Integrações → Ferramentas MCP → Adicionar Nova
Adicione a configuração acima → Salve e reinicie o Cursor

Claude Desktop:

Abra Configurações do Claude Desktop → Desenvolvedor → Editar Configuração
Adicione a configuração acima → Salve e reinicie o Claude Desktop

Outras Ferramentas Compatíveis com MCP: Este servidor foi projetado para funcionar com qualquer ferramenta compatível com MCP. Consulte a documentação da sua ferramenta para etapas de configuração do MCP, pois o processo exato varia conforme a ferramenta.

Entendendo a Configuração

O que cada configuração faz:

"namecom": O nome deste servidor MCP (você pode alterar)
"command": "npx": Usa npx para baixar e executar automaticamente a versão mais recente
"args": ["-y", "namecom-mcp@latest"]: Executa a versão mais recente sem prompts
"NAME_USERNAME": Seu nome de usuário da API do name.com (credenciais de teste recomendadas)
"NAME_TOKEN": Seu token da API do name.com (credenciais de teste recomendadas)
Opcional: Adicione "NAME_API_URL": "https://mcp.name.com" para ambiente de produção

✅ Configuração Concluída - Você Está Pronto!

Parabéns! Seu servidor MCP do name.com está configurado e pronto para uso com seu assistente de IA.

Teste Rápido

Inicie sua ferramenta de IA e pergunte: "Você pode verificar se example.com está disponível?"

Se seu assistente de IA responder e pesquisar domínios, está tudo certo! 🎉

O que você pode fazer agora:

Comece a fazer qualquer pergunta relacionada a domínios em linguagem natural
Seu assistente de IA usará automaticamente as ferramentas do name.com quando necessário

🚀 Exemplo Rápido

Agora que você está configurado, aqui está o que pode fazer:

Pergunte ao seu assistente de IA:

"Você pode pesquisar por domínios disponíveis com 'meuprojetoincrivel' no nome?"

Seu assistente de IA:

Pedirá permissão para usar a ferramenta de pesquisa de domínios
Pesquisará com segurança no ambiente de teste do name.com
Mostrará opções disponíveis com preços
Ajudará você a registrar, se desejar (no modo de teste)

Outras coisas para tentar:

"Liste meus domínios atuais"
"Mostre os registros DNS do meu domínio"
"Ajude-me a registrar um novo domínio"
"Verifique se example.com está disponível"

Detalhes do Ambiente

Entendendo os diferentes ambientes do name.com e suas credenciais:

Ambiente de Teste (Padrão - Recomendado)

URL: https://mcp.dev.name.com (padrão)
Credenciais: Use seu nome de usuário e token de teste do name.com
Segurança: As operações não afetarão domínios reais ou cobranças
Propósito: Experimentação e testes seguros

Ambiente de Produção (Avançado)

URL: https://mcp.name.com (definir NAME_API_URL=https://mcp.name.com)
Credenciais: Use seu nome de usuário e token de produção do name.com
**⚠️ PERIGO: Todas as operações afetam sua conta real e domínios no name.com
Cobrança: Registros de domínios e serviços gerarão cobranças reais
Propósito: Gerenciamento de domínios ao vivo

Correspondência de Credenciais

Crítico: Certifique-se de que suas credenciais correspondem ao seu ambiente:

Ambiente de teste (mcp.dev.name.com) → Credenciais de teste
Ambiente de produção (mcp.name.com) → Credenciais de produção

Usar credenciais incorretas resultará em erros de autenticação.

Obtendo Credenciais da API do name.com

Se você precisar gerar novas credenciais de API ou quiser entender os diferentes ambientes:

IMPORTANTE: O name.com fornece credenciais diferentes para ambientes de teste vs. produção. Certifique-se de estar usando as credenciais corretas para o ambiente escolhido.

Faça login na sua conta do name.com
Vá para Configurações da Conta > Tokens de API
Gere um token de API
Nota: Quando você gera um token, o name.com fornece:
- Credenciais de teste (nome de usuário/token) para mcp.dev.name.com
- Credenciais de produção (nome de usuário/token) para mcp.name.com
Copie o nome de usuário e token corretos para o ambiente que você pretende usar

Teste e Depuração (Opcional)

A seção a seguir é para testar e solucionar problemas da sua configuração. Se tudo estiver funcionando com seu assistente de IA, você pode pular esta seção.

Teste Básico

Inicie sua ferramenta de IA e tente estas perguntas:

"Você pode listar meus domínios?"
"Pesquise por domínios disponíveis com o nome 'exemplo'"
"Mostre-me os registros DNS do meu domínio"
"Ajude-me a registrar um novo domínio"

Sua ferramenta de IA solicitará permissão para usar as ferramentas do name.com, e a conversa deve fluir naturalmente.

Depuração Avançada: Inspetor MCP

O Inspetor MCP é excelente para testar e solucionar problemas da sua configuração do servidor MCP se você estiver enfrentando problemas.

Instale o Inspetor MCP (se ainda não estiver instalado):
```
npm install -g @modelcontextprotocol/inspector
```

Execute o Inspetor com suas credenciais:

NAME_USERNAME=your-test-username NAME_TOKEN=your-test-token npx @modelcontextprotocol/inspector namecom-mcp

Para ambiente de produção (avançado):

NAME_USERNAME=your-prod-username NAME_TOKEN=your-prod-token NAME_API_URL=https://mcp.name.com npx @modelcontextprotocol/inspector namecom-mcp

Abra o Inspetor:
- O comando exibirá uma URL local com um token de autenticação (ex.: http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=...)
- Abra esta URL no seu navegador
Teste a Conexão:
- Clique em "Conectar" na barra lateral esquerda
- Depois de conectado, clique em "Listar Ferramentas" no centro para ver todas as ferramentas disponíveis da API do name.com
- Selecione qualquer ferramenta para testar se os endpoints estão funcionando através do servidor MCP
- Se você não vir erros, mas apenas algumas ferramentas aparecerem, pode ter havido um problema ao analisar a especificação OpenAPI na inicialização. Por favor, relate esse problema.

Segurança e Desempenho

Segurança do Token de API: Trate seu token de API do name.com como uma senha
Teste Seguro: O ambiente de teste padrão fornece experimentação segura
Menor Privilégio: O servidor só acessa as APIs do name.com com as permissões do seu token de API
Validação de Entrada: Todas as entradas são validadas usando esquemas Zod
Tratamento de Erros: Erros são tratados com elegância, sem expor informações sensíveis
Limites de Taxa da API: Respeita os limites de taxa padrão do name.com
Inicialização Rápida: A geração de ferramentas leva cerca de 2-3 segundos na primeira inicialização

Solução de Problemas

Problemas Comuns

Erros de Autenticação:
- Verifique se seu NAME_USERNAME e NAME_TOKEN estão corretos
- Mais Comum: Certifique-se de estar usando as credenciais corretas para o seu ambiente (veja Detalhes do Ambiente)
- Precisa de novas credenciais? Obtenha-as aqui
Problemas com URL da API: A ferramenta usa por padrão o ambiente de teste (mcp.dev.name.com)
Falha na Geração de Ferramentas: O servidor usará ferramentas básicas se o carregamento da especificação OpenAPI falhar
Atraso na Primeira Execução:
- A primeira execução pode levar alguns segundos enquanto o npx baixa o pacote
- As execuções subsequentes serão mais rápidas devido ao cache do npm
- Se você vir mensagens "Instalando pacote...", isso é normal na primeira execução
Problemas de Configuração do MCP:
- Verifique o caminho do arquivo de configuração do MCP e a sintaxe JSON
- Reinicie sua ferramenta de IA (como o Claude Desktop) após alterações de configuração
- Certifique-se de que o array args inclua tanto -y quanto o nome do pacote

Problemas de Conexão com o Inspetor MCP:

# For test environment:
NAME_USERNAME=your-username NAME_TOKEN=your-token npx @modelcontextprotocol/inspector npx -y namecom-mcp@latest

# For production:
NAME_USERNAME=your-username NAME_TOKEN=your-token NAME_API_URL=https://mcp.name.com npx @modelcontextprotocol/inspector npx -y namecom-mcp@latest

Obtendo Ajuda

Se você encontrar problemas:

Consulte a seção de solução de problemas acima
Teste primeiro com o Inspetor MCP para isolar problemas de configuração
Verifique se suas credenciais funcionam diretamente com a API do name.com
Consulte Issues no GitHub para problemas conhecidos
Relate bugs ou solicite recursos em Issues no GitHub
Feedback geral: name.com API Feedback

Para problemas de conta ou API do name.com:

Suporte do name.com - Suporte de conta e cobrança
Documentação da API do name.com - Referência da API e guias

FAQ

P: Quais ferramentas de IA funcionam com isso? R: Qualquer ferramenta que suporte MCP - Claude Desktop, Cursor, Continue e muitas outras.

P: É seguro testar? R: Sim! O ambiente de teste padrão não afeta domínios reais ou cobranças.

P: Posso usar isso com domínios de produção? R: Sim, defina NAME_API_URL=https://mcp.name.com e use credenciais de produção. ⚠️ Isso afetará sua conta real e pode gerar cobranças.

P: Por que estou recebendo erros de autenticação? R: Geralmente é devido a credenciais incompatíveis - credenciais de teste funcionam com o ambiente de teste, credenciais de produção com o ambiente de produção. Veja Detalhes do Ambiente para requisitos de credenciais.

P: Quanto custa? R: O servidor MCP é gratuito. Você só paga pelos serviços reais do name.com que usar.

P: O npx sempre baixará o pacote? R: Não, o npm armazena o pacote em cache localmente. Apenas na primeira execução ou quando uma nova versão estiver disponível será necessário um download.

P: Preciso instalar algo além da minha ferramenta de IA? R: Não! Ferramentas como Cursor e Claude Desktop incluem tudo que é necessário. Basta instalar sua ferramenta de IA preferida e você está pronto.

P: E se eu vir "command not found: npx" ou erros semelhantes? R: Isso geralmente significa que sua ferramenta de IA não está instalada corretamente. Tente reinstalar sua ferramenta de IA (Cursor, Claude Desktop, etc.) e certifique-se de deixar o processo de configuração concluir.

P: Por que a primeira execução demora mais? R: A primeira execução precisa baixar o pacote. As execuções subsequentes serão mais rápidas, pois o pacote está em cache local.

Ecossistema MCP

Este servidor faz parte do crescente ecossistema do Model Context Protocol. O MCP está ganhando rápida adoção entre ferramentas de IA, e este servidor da name.com funciona com qualquer ferramenta compatível com MCP, dando a você flexibilidade para escolher seu assistente de IA preferido para tarefas de gerenciamento de domínios.

Recursos relacionados ao MCP:

MCP Inspector: Depure e teste servidores MCP
MCP SDK: Crie seus próprios servidores MCP
MCP Protocol: Saiba mais sobre o Model Context Protocol

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Suporte

Issues: Reporte bugs e solicitações de recursos no GitHub Issues
Documentação: Consulte a Documentação da API name.com para detalhes da API
Protocolo MCP: Saiba mais sobre o Model Context Protocol
Feedback: Queremos ouvir você! Envie feedback sobre o servidor MCP ou a API name aqui

Registro de alterações

Consulte a página de GitHub Releases para histórico de versões e atualizações.