Zip1 MCP Server

• Encurtar
• API
• MCP
• Estatísticas
• Contato

🤖 Integração com IA (MCP)

Use o zip1.io diretamente de assistentes de IA como o Claude através do Model Context Protocol (MCP). Encurte URLs, obtenha análises e gerencie links usando comandos em linguagem natural.

🤖

Gerenciamento de URLs com IA

Converse com seu encurtador de URL como você conversa com uma IA

• ✨ Interface em linguagem natural - sem necessidade de sintaxe de API
• ⚡ Encurtamento instantâneo de URL a partir do seu assistente de IA
• 📊 Obtenha análises sob demanda com prompts simples
• 🔒 Crie links protegidos por senha de forma conversacional

⚡ Configuração Rápida

Para Claude Code (Recomendado)

O Claude Code suporta servidores MCP HTTP diretamente via CLI. Basta executar:

Terminal

claude mcp add --transport http zip1 http://zip1.io/mcp

Verifique a instalação:

Terminal

claude mcp list

✅ Pronto! Agora você pode usar o zip1.io diretamente do Claude Code.

Para Claude Desktop

⚠️ Requer Proxy: O Claude Desktop suporta apenas servidores MCP baseados em stdio, não servidores HTTP. Você precisará de um proxy local para fazer a ponte da conexão.

Opção 1: Usando mcp-client-cli (Recomendado)

Instale a ferramenta CLI do cliente MCP para conectar stdio ao HTTP:

Terminal

npm install -g @modelcontextprotocol/client-cli

Depois edite o arquivo de configuração do Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione esta configuração:

claude_desktop_config.json

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["http://zip1.io/mcp"]
    }
  }
}

Reinicie o Claude Desktop e as ferramentas do zip1.io estarão disponíveis.

Opção 2: Proxy Node.js Personalizado

Para usuários avançados, crie um script de ponte stdio-para-HTTP personalizado:

zip1-mcp-proxy.js

#!/usr/bin/env node
const https = require('https');
const readline = require('readline');

const MCP_URL = 'http://zip1.io/mcp';

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  terminal: false
});

rl.on('line', (line) => {
  const request = JSON.parse(line);

  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    }
  };

  const req = https.request(MCP_URL, options, (res) => {
    let data = '';
    res.on('data', (chunk) => data += chunk);
    res.on('end', () => {
      console.log(data);
    });
  });

  req.on('error', (error) => {
    console.error(JSON.stringify({
      jsonrpc: '2.0',
      id: request.id,
      error: { code: -32000, message: error.message }
    }));
  });

  req.write(JSON.stringify(request));
  req.end();
});

Torne-o executável e adicione à configuração do Claude Desktop:

Terminal

chmod +x zip1-mcp-proxy.js

{
  "mcpServers": {
    "zip1": {
      "command": "node",
      "args": ["/path/to/zip1-mcp-proxy.js"]
    }
  }
}

⚙️ Configuração do Servidor

O servidor MCP do zip1.io está disponível como um endpoint HTTP ao qual qualquer cliente compatível com MCP pode se conectar.

Detalhes do Servidor

Item de Configuração	Valor
URL do Servidor	http://zip1.io/mcp
Transporte	HTTP (Streamable)
Versão do Protocolo	MCP 2024-11-05
Formato da Mensagem	JSON-RPC 2.0
Autenticação	Nenhuma (limitado por taxa)
Limite de Taxa	30 requisições/minuto por IP
Ferramentas Disponíveis	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Usando com Outros Clientes MCP

Qualquer cliente compatível com MCP que suporte transporte HTTP pode se conectar ao zip1.io. Aqui estão alguns exemplos:

Requisições HTTP Diretas (curl)

Listar Ferramentas Disponíveis

curl -X POST http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Criar uma URL Curta

curl -X POST http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_short_url",
      "arguments": {
        "url": "https://example.com",
        "alias": "my-link"
      }
    }
  }'

Exemplo de Cliente Python

Script Python

import requests

MCP_URL = "http://zip1.io/mcp"

def call_mcp_tool(tool_name, arguments):
    payload = {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": tool_name,
            "arguments": arguments
        }
    }

    response = requests.post(MCP_URL, json=payload)
    return response.json()

# Example usage
result = call_mcp_tool("create_short_url", {
    "url": "https://github.com/anthropics/claude-mcp",
    "alias": "mcp-docs"
})

print(result)

Configuração Auto-Hospedada

Se você estiver executando sua própria instância do zip1.io, configure os clientes para apontar para sua instância:

Claude Code

claude mcp add --transport http zip1 https://your-domain.com/mcp

Claude Desktop (com mcp-client)

{
  "mcpServers": {
    "zip1-local": {
      "command": "mcp-client",
      "args": ["http://localhost:8000/mcp"]
    }
  }
}

💬 Exemplos de Conversas

Aqui estão alguns prompts em linguagem natural que você pode usar com o Claude:

Criando URLs Curtas

Prompt

"Shorten https://github.com/anthropics/claude-mcp for me"

Resposta do Claude:
✅ URL curta criada: https://zip1.io/\[código\]
🔤 Código gerado: [código]
🔗 URL original: https://github.com/anthropics/claude-mcp
📊 Ver estatísticas: https://zip1.io/stats/\[código\]

Apelidos Personalizados e Senhas

Prompt

"Create a short URL for https://docs.myapp.com with alias 'docs' and password 'team2024'"

Resposta do Claude:
✅ URL curta criada: https://zip1.io/docs
📝 Apelido personalizado: docs
🔒 Protegida por senha: Sim
🔗 URL original: https://docs.myapp.com

Obtendo Análises

Prompt

"Show me the stats for short code 'docs'"

Resposta do Claude:
📊 Estatísticas para: https://zip1.io/docs
👆 Total de cliques: 127
👤 Cliques únicos: 89
🔒 Protegida por senha: Sim
📅 Criada: 2024-01-15T10:30:00

🌍 Principais países:
1. Estados Unidos: 54 cliques
2. Reino Unido: 23 cliques
3. Canadá: 18 cliques

Validação de URL

Prompt

"Can I shorten ftp://myserver.com/file.zip?"

Resposta do Claude:
❌ URL inválida: Deve incluir o protocolo http:// ou https:// e um domínio válido

🛠️ Ferramentas Disponíveis

O servidor MCP do zip1.io fornece quatro ferramentas que o Claude pode usar:

Ferramenta	Descrição	Exemplo de Uso
create_short_url	Cria URLs encurtadas com apelidos personalizados, senhas e máximo de cliques opcionais	"Encurte esta URL com o apelido 'meulink'"
get_url_stats	Recupera análises detalhadas incluindo cliques, países e registros de data e hora	"Obtenha estatísticas para o código curto 'abc123'"
validate_url	Verifica se uma URL é válida e pode ser encurtada	"Posso encurtar exemplo.com?"
generate_short_code	Gera uma sugestão de código curto aleatório	"Gere um código curto aleatório"

🔧 Detalhes Técnicos

Endpoint MCP

GET /mcp

Retorna informações do servidor, ferramentas disponíveis e detalhes de configuração.

Informações do Protocolo

• Versão do Protocolo: MCP 2024-11-05
• Transporte: HTTP Streamable
• Formato da Mensagem: JSON-RPC 2.0
• Limite de Taxa: 30 requisições por minuto por IP

Segurança

• Toda comunicação usa criptografia HTTPS
• Senhas são hashadas com bcrypt antes do armazenamento
• Limitação de taxa previne abusos
• Mesma infraestrutura de segurança da API REST

💡 Casos de Uso

📝 Criação de Conteúdo

Gere URLs curtas enquanto escreve posts de blog, documentação ou conteúdo para redes sociais sem sair do seu assistente de IA.

📊 Análises Rápidas

Pergunte sobre o desempenho dos links durante as conversas. "Quantos cliques meu link de campanha recebeu?"

🔐 Compartilhamento Seguro

Crie links protegidos por senha na hora ao compartilhar informações sensíveis em chats de equipe.

🎯 Gerenciamento de Campanhas

Crie URLs com apelidos personalizados para campanhas de marketing com comandos em linguagem natural.

🔍 Solução de Problemas

Erros de limite de taxa?

• O endpoint MCP tem um limite de 30 requisições por minuto
• Aguarde um minuto e tente novamente

Ferramentas não aparecem no Claude Code?

• Certifique-se de que a URL do servidor MCP está acessível
• Tente visitar http://zip1.io/mcp no seu navegador
• Verifique sua configuração MCP com claude mcp list

📚 Recursos e Documentação

• Documentação Oficial do MCP - Saiba mais sobre o Model Context Protocol
• SDK MCP para Python - Construa seus próprios servidores MCP
• Documentação da API REST - Acesso tradicional à API

Pronto para Começar?

Adicione o zip1.io ao Claude Code agora e comece a encurtar URLs com IA

Configuração Rápida