Servidor MCP

O servidor Model Context Protocol do seven permite que assistentes de IA como Claude Desktop, Claude Code e Cursor interajam diretamente com a API do seven.io. Ele expõe SMS, RCS, voz, consultas, contatos e gerenciamento de conta como mais de 40 ferramentas em 12 categorias.

O servidor é distribuído como o pacote npm @seven.io/mcp e é executado localmente via npx sobre o transporte stdio do MCP. O código-fonte está disponível no GitHub.

Instalação

npm install -g @seven.io/mcp

Você também pode dispensar a instalação global — npx @seven.io/mcp baixa a versão mais recente sob demanda sempre que o cliente MCP iniciar o servidor.

Autenticação

O servidor suporta dois métodos de autenticação. Recomenda-se OAuth 2.0 com PKCE — fornece renovação automática de tokens, escopos refinados e armazena os tokens com segurança no chaveiro do seu sistema operacional. Se ambos os métodos estiverem configurados, o OAuth tem prioridade.

Opção 1: OAuth 2.0 (recomendado)

Execute o comando de login uma vez. Ele abre o navegador, solicita os escopos necessários (SMS, Voz, RCS, …) e armazena os tokens.

npx @seven.io/mcp login

Outros comandos CLI:

# Mostrar se você está autenticado
npx @seven.io/mcp status

# Remover os tokens armazenados
npx @seven.io/mcp logout

Opção 2: chave de API (legado)

Defina a variável de ambiente SEVEN_API_KEY. Crie sua chave no painel do seven.io.

export SEVEN_API_KEY="sua-chave-api"

Configurações headless ou remotas

O fluxo de login OAuth precisa de um navegador na mesma máquina que consiga acessar 127.0.0.1:7177 / 9437 / 8659. Se você executar o servidor MCP em um sistema sem interface gráfica ou via SSH sem encaminhamento de portas, use a chave de API (Opção 2) — esse caminho dispensa o navegador.

Início rápido

Adicione o servidor à configuração do seu cliente MCP e reinicie o cliente.

Claude Desktop

Edite seu arquivo claude_desktop_config.json:

Com OAuth (recomendado) — execute npx @seven.io/mcp login antes:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"]
    }
  }
}

Com chave de API:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "SEVEN_API_KEY": "sua-chave-api"
      }
    }
  }
}

Claude Code

claude mcp add seven npx @seven.io/mcp

Cursor

Adicione o servidor ao arquivo .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"]
    }
  }
}

Ferramentas disponíveis

O servidor fornece mais de 40 ferramentas agrupadas por funcionalidade.

Mensagens

Conta

Consultas

Status e diário

Números de telefone

Contatos

Grupos

Subcontas

Webhooks

Remetente

Exemplos

Quando o servidor estiver conectado, você pode pedir ao assistente em linguagem natural. O cliente MCP escolhe a ferramenta certa automaticamente.

Enviar um SMS:

Envie um SMS para +49170123456789 com o texto 'Pedido enviado — acompanhe em example.com/t/abc123'.

O assistente chama send_sms.

Consultar o saldo:

Qual é o saldo da minha conta seven.io?

O assistente chama get_balance.

Consulta de operadora e verificação de RCS:

Procure a operadora do +49170123456789 e me diga se o número suporta RCS.

O assistente encadeia lookup_mnp e lookup_rcs.

Registro de depuração

Defina SEVEN_LOG_FILE para registrar cada requisição e resposta da API em um arquivo. Útil quando uma chamada de ferramenta não se comporta como esperado.

{
  "mcpServers": {
    "seven": {
      "command": "npx",
      "args": ["@seven.io/mcp"],
      "env": {
        "SEVEN_API_KEY": "sua-chave-api",
        "SEVEN_LOG_FILE": "/tmp/mcp-seven-debug.log"
      }
    }
  }
}

Em seguida, acompanhe o arquivo de log:

tail -f /tmp/mcp-seven-debug.log

Recursos

• Repositório no GitHub
• Pacote npm
• Especificação do Model Context Protocol
• Rastreador de issues