Rezdy Agent

Pesquise produtos do marketplace, gerencie reservas e lide com relacionamentos com clientes usando a API do Rezdy Agent.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Servidor MCP do Rezdy Agent

Um servidor Model Context Protocol (MCP) para integração com a API do Rezdy Agent. Este servidor fornece ferramentas para agentes de viagem pesquisarem produtos do marketplace, gerenciarem reservas, lidarem com relacionamentos com clientes e processarem pagamentos por meio do Claude.

Recursos

  • Pesquisa de Produtos no Marketplace: Pesquise produtos de todos os fornecedores com filtros avançados
  • Disponibilidade e Preços: Pesquisa de disponibilidade em tempo real com cálculos de comissão do agente
  • Gerenciamento de Reservas: Cotações, criação, atualização e cancelamento de reservas com suporte a processo em 2 etapas
  • Gerenciamento de Clientes: Banco de dados de clientes de propriedade do agente com operações CRUD completas
  • Processamento de Pagamentos: Suporte para fluxos de pagamento manuais e automatizados
  • Cálculos de Comissão: Preços de agente e tratamento de comissões integrados
  • Limitação de Taxa: Limitação automática de taxa (100 chamadas/minuto) com fila inteligente
  • Suporte a Ambientes: Ambientes de staging e produção

Início Rápido

1. Instalação

Primeiro, clone e compile o servidor MCP:

git clone https://github.com/jezweb/rezdy-agent-mcp.git
cd rezdy-agent-mcp
npm install
npm run build

2. Configuração com Claude Desktop

Adicione o servidor à sua configuração do Claude Desktop:

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

{
  "mcpServers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

3. Configuração com Outros Editores

Roo (Roo.dev)

Adicione à sua configuração do Roo:

{
  "mcp": {
    "servers": {
      "rezdy-agent": {
        "command": "node",
        "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
      }
    }
  }
}

Cline (Extensão do VS Code)

  1. Instale a extensão Cline no VS Code
  2. Abra as configurações do VS Code (Cmd/Ctrl + ,)
  3. Pesquise por "Cline MCP"
  4. Adicione a configuração do servidor:
{
  "cline.mcp.servers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

Cursor

  1. Abra as Configurações do Cursor
  2. Navegue até Extensões > MCP
  3. Adicione o servidor:
{
  "mcpServers": {
    "rezdy-agent": {
      "command": "node",
      "args": ["/path/to/rezdy-agent-mcp/build/index.js"]
    }
  }
}

4. Implantação com Docker (Alternativa)

Para implantação em contêiner, você pode usar o Docker:

Opção A: Docker Compose (Recomendado)

  1. Clone o repositório:
git clone https://github.com/jezweb/rezdy-agent-mcp.git
cd rezdy-agent-mcp
  1. Crie um arquivo .env:
REZDY_API_KEY=your-agent-api-key-here
REZDY_ENVIRONMENT=production
  1. Inicie o contêiner:
npm run docker:compose:up
  1. Para Claude Desktop, use o caminho do contêiner Docker:
{
  "mcpServers": {
    "rezdy-agent": {
      "command": "docker",
      "args": [
        "exec",
        "rezdy-agent-mcp",
        "node",
        "build/index.js"
      ]
    }
  }
}

Opção B: Build e Execução com Docker

# Build the Docker image
npm run docker:build

# Run the container
docker run --rm -it \
  -e REZDY_API_KEY=your-api-key \
  -e REZDY_ENVIRONMENT=production \
  rezdy-agent-mcp

Comandos de Gerenciamento do Docker

# Start services
npm run docker:compose:up

# Stop services
npm run docker:compose:down

# View logs
npm run docker:compose:logs

# Rebuild container
npm run docker:compose:build

5. Obtenha Sua Chave de API do Rezdy Agent

  1. Faça login na sua conta do Rezdy Agent
  2. Vá para Configurações > Chaves de API
  3. Crie uma nova chave de API do Agent
  4. Copie a chave de API para configuração

6. Configure o Servidor

Após conectar, configure o servidor com suas credenciais do Rezdy Agent:

Use the rezdy_agent_configure tool with:
- apiKey: "your-agent-api-key"
- environment: "staging" or "production"

Exemplo: "Configure o Rezdy Agent com minha chave de API abc123 para o ambiente de staging"

O assistente executará:

rezdy_agent_configure({
  apiKey: "abc123",
  environment: "staging"
})

Ferramentas Disponíveis

Configuração

  • rezdy_agent_configure - Configure a chave de API e o ambiente

Gerenciamento de Produtos do Marketplace

  • rezdy_agent_search_products - Pesquise produtos do marketplace com filtros
  • rezdy_agent_get_product - Obtenha informações detalhadas do produto
  • rezdy_agent_get_product_pickups - Obtenha locais de embarque para produtos

Disponibilidade e Preços

  • rezdy_agent_search_availability - Pesquise disponibilidade com preços de agente

Gerenciamento de Reservas

  • rezdy_agent_quote_booking - Obtenha cotações de reservas com detalhes de comissão
  • rezdy_agent_create_booking - Crie reservas confirmadas
  • rezdy_agent_get_booking - Obtenha detalhes da reserva
  • rezdy_agent_update_booking - Atualize reservas existentes
  • rezdy_agent_cancel_booking - Cancele reservas

Gerenciamento de Clientes

  • rezdy_agent_search_customers - Pesquise o banco de dados de clientes do agente
  • rezdy_agent_create_customer - Crie novos perfis de clientes
  • rezdy_agent_get_customer - Obtenha detalhes do cliente

Dados do Marketplace

  • rezdy_agent_get_categories - Obtenha categorias de produtos
  • rezdy_agent_get_locations - Obtenha locais do marketplace
  • rezdy_agent_get_suppliers - Obtenha fornecedores do marketplace

Como Usar

Após configurado, você pode interagir com o marketplace do Rezdy por meio de linguagem natural. Aqui estão alguns exemplos:

Primeiros Passos

  • "Configure o Rezdy Agent com minha chave de API abc123 para produção"
  • "Mostre-me todas as categorias do marketplace"
  • "Encontre fornecedores em Sydney"

Descoberta de Produtos

  • "Pesquise por passeios de vinho em Sydney abaixo de $200"
  • "Encontre atividades de esportes aquáticos para a próxima semana"
  • "Mostre-me produtos do fornecedor ID 456"
  • "Obtenha detalhes do produto 789 incluindo locais de embarque"

Disponibilidade e Preços

  • "Verifique a disponibilidade do produto 123 na próxima semana"
  • "Mostre-me os preços para 2 adultos no produto 456 para amanhã"
  • "O que está disponível para o produto 789 em dezembro?"

Processo de Reserva

  • "Obtenha uma cotação para João Silva (joao@exemplo.com) para o produto 123 com 2 adultos"
  • "Crie uma reserva para Maria Santos para o produto 456 amanhã às 10h"
  • "Atualize a reserva ABC123 com o novo telefone do cliente"
  • "Cancele a reserva DEF456 devido às condições climáticas"

Gerenciamento de Clientes

  • "Pesquise clientes com e-mail contendo 'gmail'"
  • "Crie um perfil de cliente para Pedro Souza (pedro@email.com)"
  • "Mostre-me os detalhes do cliente ID 789"

Recursos Principais

Funcionalidades Específicas do Agente

  • Cálculos de Comissão: Cálculo automático de comissões e descontos do agente
  • Preços de Agente: Suporte para tarifas especiais de agente e descontos por volume
  • Banco de Dados de Clientes: Perfis de clientes de propriedade do agente para reservas recorrentes
  • Opções de Pagamento: Escolha entre processamento de pagamento manual e automatizado

Pesquisa e Filtros Avançados

  • Filtre por local, região, país
  • Filtragem por faixa de preço
  • Filtros de duração e categoria
  • Pesquisas específicas por fornecedor
  • Filtragem baseada em tags

Flexibilidade de Reservas

  • Suporte para diferentes modos de reserva (NO_DATE, DATE_ENQUIRY, INVENTORY)
  • Processo de reserva em 2 etapas
  • Campos de reserva personalizados
  • Gerenciamento de participantes
  • Suporte a códigos promocionais

Processamento de Pagamentos

Pagamentos Manuais (Padrão)

  • O agente processa o pagamento fora do Rezdy
  • Reserva criada com pagamento pendente
  • O agente marca o pagamento como recebido manualmente

Pagamentos Automatizados (RezdyPay)

  • Processamento completo de pagamento pelo Rezdy
  • Confirmação automática de pagamento
  • Processamento de cartão de crédito com conformidade PCI

Exemplos de Uso (Técnico)

Se você precisar ver as chamadas exatas das ferramentas, aqui estão exemplos:

1. Configure o Servidor

rezdy_agent_configure({
  apiKey: "your-agent-api-key-here",
  environment: "production"
})

2. Pesquise Produtos do Marketplace

rezdy_agent_search_products({
  limit: 20,
  location: "Sydney",
  categoryId: 5,
  minPrice: 50,
  maxPrice: 200,
  tags: ["wine", "food"]
})

3. Verifique Disponibilidade com Preços

rezdy_agent_search_availability({
  productId: 123,
  startDate: "2024-01-15",
  endDate: "2024-01-22",
  quantities: [
    { optionId: 1, value: 2 }, // 2 adults
    { optionId: 2, value: 1 }  // 1 child
  ]
})

4. Faça uma Cotação de Reserva

rezdy_agent_quote_booking({
  productId: 123,
  sessionId: "session-456",
  quantities: [{ optionId: 1, value: 2 }],
  customer: {
    firstName: "John",
    lastName: "Doe",
    email: "john@example.com"
  },
  paymentType: "MANUAL",
  agentReference: "AGENT-REF-001"
})

5. Crie uma Reserva

rezdy_agent_create_booking({
  productId: 123,
  sessionId: "session-456",
  quantities: [{ optionId: 1, value: 2 }],
  customer: {
    firstName: "John",
    lastName: "Doe",
    email: "john@example.com",
    phone: "+1234567890",
    address: {
      city: "Sydney",
      country: "Australia"
    }
  },
  paymentType: "AUTOMATED",
  agentReference: "BOOKING-001",
  notes: "Customer has mobility requirements"
})

Referência da API

Operações do Marketplace

  • Pesquise produtos em todos os fornecedores com filtragem abrangente
  • Obtenha informações detalhadas do produto, incluindo descrições, imagens e preços
  • Recupere locais de embarque e pontos de encontro
  • Acesse informações e avaliações de fornecedores

Disponibilidade e Preços

  • Verificação de disponibilidade em tempo real com informações de capacidade
  • Preços específicos do agente com cálculos de comissão
  • Suporte para reservas em grupo e múltiplas opções de preço
  • Validação de códigos promocionais e aplicação de descontos

Operações de Reserva

  • Processo de reserva em duas etapas (cotação → confirmação)
  • Suporte para requisitos complexos de reserva
  • Gerenciamento de participantes para reservas em grupo
  • Suporte a campos personalizados para requisitos específicos do fornecedor

Gerenciamento de Clientes

  • Banco de dados de clientes de propriedade do agente
  • Gerenciamento completo de perfis de clientes
  • Recursos de pesquisa e filtragem
  • Histórico do cliente e rastreamento de preferências

Limitação de Taxa

O servidor lida automaticamente com a limitação de taxa do Rezdy (100 chamadas por minuto) ao:

  • Rastrear contagens de solicitações por minuto
  • Colocar solicitações em fila quando o limite é atingido
  • Tentar novamente automaticamente após a janela de limitação de taxa

Tratamento de Erros

O servidor fornece tratamento abrangente de erros:

  • Valida todos os parâmetros de entrada usando esquemas Zod
  • Trata erros da API do Rezdy de forma graciosa
  • Fornece mensagens de erro claras para depuração
  • Valida dados do cliente e requisitos de reserva
  • Verifica formatos de data e regras de negócio

Solução de Problemas

Problemas Comuns

Erro "Cliente do Rezdy Agent não configurado"

  • Certifique-se de executar a etapa de configuração primeiro: "Configure o Rezdy Agent com minha chave de API..."
  • Verifique se sua chave de API do Agent está correta e possui as permissões adequadas

Erro "Limite de taxa excedido"

  • O servidor lida automaticamente com a limitação de taxa, mas se você vir este erro, aguarde um minuto e tente novamente
  • Considere reduzir a frequência das solicitações

Erro "Datas de reserva inválidas"

  • Certifique-se de que as datas estejam no formato correto (AAAA-MM-DD para datas, ISO 8601 para data-hora)
  • Verifique se as datas de reserva não estão no passado
  • Verifique se a data final é posterior à data inicial

Servidor Não Encontrado no Claude Desktop

  • Verifique se o caminho no seu claude_desktop_config.json está correto
  • Certifique-se de que o servidor foi compilado com sucesso (npm run build)
  • Reinicie o Claude Desktop após fazer alterações na configuração

Erros de Permissão

  • Certifique-se de que o arquivo build/index.js tenha permissões de execução
  • Em sistemas Unix: chmod +x build/index.js

Obtendo Ajuda

Se você encontrar problemas:

  1. Verifique a página de Issues
  2. Revise a documentação da API do Rezdy Agent
  3. Verifique as permissões da sua chave de API nas configurações do Rezdy Agent

Desenvolvimento

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Adicione testes se aplicável
  5. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes