Obelinf

Servidor MCP Obelinf

Servidor Model Context Protocol hospedado para Obelinf, a plataforma de documentação de rede e infraestrutura. Conecte agentes de IA como Claude, Cursor ou Codex aos seus registros de infraestrutura e permita que eles consultem, respondam e atualizem sites, racks, dispositivos, espaço de endereços IP e cabeamento por meio de um único endpoint.

Este repositório não contém o código-fonte do servidor. Ele contém os metadados de listagem do MCP, documentação de conexão, o changelog da superfície MCP e o rastreador público de issues.

• Site: https://obelinf.com
• Documentação da API: https://obelinf.com/docs/api/
• Visão geral dos recursos do MCP: https://obelinf.com/features/ai-infrastructure-documentation/

Início rápido

1. Entre em obelinf.com e abra sua organização. O MCP está disponível em todos os planos, incluindo o plano Personal gratuito.
2. Crie uma chave de API: Painel → API Keys → crie uma chave e escolha um escopo: Read Only ou Full Access. Copie-a quando for exibida; ela só é mostrada uma vez.
3. Adicione o servidor ao seu cliente MCP. Seu endpoint é https://api.obelinf.com/mcp. A organização é selecionada a partir da sua conta Obelinf autenticada.

ChatGPT

O ChatGPT usa OAuth. Adicione o endpoint MCP e conclua o fluxo de aprovação do Obelinf quando solicitado. Google e GitHub continuam sendo os métodos de entrada disponíveis no Obelinf; o ChatGPT recebe um token MCP de curta duração, com escopo da organização, após a aprovação.

Cursor (plugin)

Instale o repositório Obelinf/mcp como um plugin do Cursor a partir do diretório Cursor. Defina OBELINF_API_KEY uma vez em Plugins → Configure e o servidor se conecta automaticamente. Não é necessário editar JSON manualmente.

Para adicioná-lo manualmente, use a configuração abaixo.

Claude Code

claude mcp add --transport http obelinf "https://api.obelinf.com/mcp" \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop, Cursor e outros clientes configurados por JSON

{
  "mcpServers": {
    "obelinf": {
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "obelinf": {
      "type": "http",
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Outros clientes MCP: aponte-os para a URL acima via Streamable HTTP e envie a chave de API como um cabeçalho Authorization: Bearer.

Detalhes do endpoint

Propriedade	Valor
Endpoint	https://api.obelinf.com/mcp
Transporte	MCP Streamable HTTP
Autenticação	OAuth para ChatGPT; chaves de API com escopo para outros clientes
Limite de taxa	100 solicitações por minuto
Disponibilidade	Todos os planos
Ferramentas	52

Ferramentas

Grupo	Ferramentas	Descrição
Pesquisa	search	Pesquisa de texto completo entre recursos no seu inventário
Sites	list_sites, get_site, create_site, update_site, delete_site	Locais físicos e sites de data centers
Racks	list_racks, get_rack, create_rack, update_rack, delete_rack	Inventário de racks, unidades e posições
Dispositivos	list_devices, get_device, create_device, update_device, delete_device	Servidores, switches, appliances e VMs
Sub-redes	list_subnets, get_subnet, create_subnet, update_subnet, delete_subnet	Sub-redes e prefixos IPAM
Endereços IP	list_ip_addresses, get_ip_address, create_ip_address, update_ip_address, delete_ip_address	Endereços atribuídos e livres
VLANs	list_vlans, get_vlan, create_vlan, update_vlan, delete_vlan	Grupos e IDs de VLAN
VRFs	list_vrfs, get_vrf, create_vrf, update_vrf, delete_vrf	Instâncias de roteamento e encaminhamento virtual
Cabos	list_cables, get_cable, create_cable, update_cable, delete_cable	Cabeamento entre portas e endpoints
Endereços MAC	list_mac_addresses, get_mac_address, create_mac_address, update_mac_address, delete_mac_address	Inventário e atribuições de MAC
Contatos	list_contacts, get_contact, create_contact, update_contact, delete_contact	Pessoas e fornecedores vinculados à infraestrutura
Changelog	list_changelog	Trilha de auditoria de cada alteração, com autor e diffs em nível de campo

Permissões

• Chaves Somente leitura podem usar todas as ferramentas de leitura e pesquisa. Ferramentas de escrita retornam um erro.
• Chaves Acesso total podem ler e escrever. Cada escrita é registrada no changelog da organização com atribuição e diffs em nível de campo, para que edições de agentes sejam tão revisáveis quanto as manuais.

Inicie agentes com uma chave Somente leitura, revise os diffs e promova para Acesso total deliberadamente.

Suporte

• Relatórios de bugs e solicitações de recursos para a superfície MCP: abra uma issue
• Planos, preços e acordos empresariais: Fale com vendas