Zip1

oficial

Um encurtador de URL gratuito

Ver em zip1.ioExperimente este MCPPatrocinado

O que você pode fazer com Zip1 MCP?

Encurtar URLs — Peça ao seu assistente para criar um link curto a partir de qualquer URL válida usando create_short_url.
Aliases personalizados e senhas — Solicite um link curto personalizado com um alias customizado e proteção opcional por senha via create_short_url.
Verificar validade da URL — Pergunte se uma URL pode ser encurtada antes de criar um link, usando a ferramenta validate_url.
Recuperar análises do link — Obtenha contagens de cliques, visitantes únicos e principais países para qualquer código curto com get_url_stats.
Gerar códigos curtos — Peça uma sugestão de código curto aleatório para usar como alias personalizado.

Documentação

🤖 Integração de 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

Fale com seu encurtador de URLs como você fala com uma IA

✨ Interface em linguagem natural - sem necessidade de sintaxe de API
⚡ Encurtamento instantâneo de URLs pelo seu assistente de IA
📊 Obtenha análises sob demanda com comandos 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:

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

Verifique a instalação:

claude mcp list

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

Para Claude Desktop

⚠️ Requer Proxy: O Claude Desktop só suporta 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 fazer a ponte entre stdio e HTTP:

npm install -g @modelcontextprotocol/client-cli

Em seguida, 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:

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["https://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:

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

const MCP_URL = 'https://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:

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	`https://zip1.io/mcp`
Transporte	HTTP (Streamable)
Versão do Protocolo	MCP 2024-11-05
Formato de Mensagem	JSON-RPC 2.0
Autenticação	Nenhuma (com limite de 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)

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

curl -X POST https://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 com Cliente Python

import requests

MCP_URL = "https://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 mcp add --transport http zip1 https://your-domain.com/mcp

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

💬 Exemplos de Conversas

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

Criando URLs Curtas

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

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

Aliases Personalizados e Senhas

"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
📝 Alias personalizado: docs
🔒 Protegido por senha: Sim
🔗 URL original: https://docs.myapp.com

Obtendo Análises

"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
🔒 Protegido por senha: Sim
📅 Criado em: 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

"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`	Criar URLs encurtadas com aliases personalizados opcionais, senhas e limite de cliques	"Encurte esta URL com o alias 'mylink'"
`get_url_stats`	Obter análises detalhadas incluindo cliques, países e carimbos de data/hora	"Obtenha estatísticas para o código curto 'abc123'"
`validate_url`	Verificar se uma URL é válida e pode ser encurtada	"Posso encurtar example.com?"
`generate_short_code`	Gerar uma sugestão aleatória de código curto	"Gere um código curto aleatório"

description em create_short_url é uma nota privada opcional para sua própria integração, com até 100 caracteres. Ela não é exibida nas páginas públicas do link. Mantenha-a livre de dados pessoais que você não queira armazenar. A resposta de criação a retorna.

🔧 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 de 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 criptografadas com bcrypt antes do armazenamento
Limite de taxa previne abuso
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 de links durante conversas. "Quantos cliques meu link de campanha teve?"

🔐 Compartilhamento Seguro

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

🎯 Gerenciamento de Campanhas

Crie URLs com aliases 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 https://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 Python do MCP - Crie seus próprios servidores MCP
Documentação da API REST - Acesso tradicional via API

Pronto para Começar?

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

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