Didlogic MCP Server

Interaja com a API Didlogic para serviços de telecomunicação, incluindo números de telefone virtuais e SMS.

Documentação

Servidor MCP Didlogic

Uma implementação de servidor Model Context Protocol (MCP) para a API Didlogic. Este servidor permite que Modelos de Linguagem de Grande Porte (LLMs) interajam com os serviços Didlogic por meio de uma interface padronizada.

Recursos

Acesso completo à API Didlogic por meio de ferramentas MCP
Prompts especializados para operações comuns
Ferramentas de gerenciamento de saldo
Gerenciamento de contas SIP (sipfriends)
Gerenciamento de restrições de IP
Gerenciamento de compras
Acesso ao histórico de chamadas
Acesso ao histórico de transações

Instalação

Usando uv (recomendado)

Ao usar uv, nenhuma instalação específica é necessária. Usaremos uvx para executar diretamente o didlogic_mcp.

Usando PIP

Alternativamente, você pode instalar didlogic_mcp via pip:

pip install didlogic_mcp

Após a instalação, você pode executá-lo como um script usando:

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

Modos de Transporte

O servidor suporta três modos de transporte:

Modo STDIO (Padrão)

Para integração local com Claude Desktop ou ferramentas similares. Usa a variável de ambiente DIDLOGIC_API_KEY para autenticação.

# Using uvx (recommended)
DIDLOGIC_API_KEY=your_key uvx didlogic_mcp

# Using uv run
DIDLOGIC_API_KEY=your_key uv run didlogic_mcp

# As Python module
DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio

Modo HTTP

Para acesso remoto e clientes web. Requer token Bearer no cabeçalho Authorization para cada requisição.

# Using default port (8000)
python -m didlogic_mcp --transport http

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport http

# Custom host and port
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport http --log-level DEBUG

Variáveis de Ambiente:

PORT - Porta do servidor (padrão: 8000)
DIDLOGIC_API_URL - URL base da API Didlogic (padrão: https://app.didlogic.com/api)

Observação: No modo HTTP, os clientes devem fornecer sua chave de API como token Bearer no cabeçalho Authorization.

Modo SSE (Server-Sent Events)

Para comunicação em streaming com conexões persistentes. Ideal para atualizações em tempo real e cenários de streaming. Requer token Bearer no cabeçalho Authorization para cada requisição.

# Using default port (8000)
python -m didlogic_mcp --transport sse

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport sse

# Custom host and port
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport sse --log-level DEBUG

Variáveis de Ambiente:

PORT - Porta do servidor (padrão: 8000)
DIDLOGIC_API_URL - URL base da API Didlogic (padrão: https://app.didlogic.com/api)

Observação: No modo SSE, os clientes devem fornecer sua chave de API como token Bearer no cabeçalho Authorization para conexões de streaming persistentes.

Configuração

Configurar para Claude.app

Adicione às suas configurações do Claude:

Usando uvx

"mcpServers": {
  "didlogic": {
    "command": "uvx",
    "args": ["didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Usando instalação via pip

"mcpServers": {
  "didlogic": {
    "command": "python",
    "args": ["-m", "didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Configurar para Claude Code

Para Claude Code, você pode se conectar a uma instância de servidor SSE em execução:

claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"

Pré-requisitos:

Inicie o servidor no modo SSE: python -m didlogic_mcp --transport sse
Execute o comando acima, substituindo YOUR_DIDLOGIC_API_KEY pela sua chave de API real
O servidor deve estar em execução e acessível na URL especificada

Configuração personalizada:

Para usar uma porta diferente: Altere http://localhost:8000/sse para corresponder à configuração de PORTA do seu servidor
Para conectar a um servidor remoto: Substitua localhost pelo nome do host ou endereço IP do servidor

Licença

MIT