Automação do Square via Rube MCP

Automatize o processamento de pagamentos do Square, gerenciamento de pedidos e faturamento através do kit de ferramentas Square da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Square via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas square
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas square
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Square
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Monitorar Pagamentos

Quando usar: O usuário deseja visualizar o histórico de pagamentos ou verificar o status do pagamento

Sequência de ferramentas:

1. SQUARE_LIST_PAYMENTS - Recuperar pagamentos com filtros opcionais [Obrigatório]
2. SQUARE_CANCEL_PAYMENT - Cancelar um pagamento pendente, se necessário [Opcional]

Parâmetros principais:

• begin_time / end_time: Timestamps RFC 3339 para filtragem de intervalo de datas
• sort_order: 'ASC' ou 'DESC' para ordenação cronológica
• cursor: Cursor de paginação da resposta anterior
• location_id: Filtrar pagamentos por localização específica

Armadilhas:

• Timestamps devem estar no formato RFC 3339 (ex: '2024-01-01T00:00:00Z')
• Paginação necessária para grandes conjuntos de resultados; siga cursor até que esteja ausente
• Apenas pagamentos pendentes podem ser cancelados; pagamentos concluídos exigem reembolsos
• SQUARE_CANCEL_PAYMENT requer o payment_id exato dos resultados da lista

2. Pesquisar e Gerenciar Pedidos

Quando usar: O usuário deseja encontrar pedidos por critérios ou atualizar detalhes do pedido

Sequência de ferramentas:

1. SQUARE_LIST_LOCATIONS - Obter IDs de localização para filtragem [Pré-requisito]
2. SQUARE_SEARCH_ORDERS - Pesquisar pedidos com filtros [Obrigatório]
3. SQUARE_RETRIEVE_ORDER - Obter detalhes completos de um pedido específico [Opcional]
4. SQUARE_UPDATE_ORDER - Modificar o estado ou detalhes do pedido [Opcional]

Parâmetros principais:

• location_ids: Array de IDs de localização para pesquisar (obrigatório para pesquisa)
• query: Objeto de filtro de pesquisa com intervalos de datas, estados, tipos de fulfillment
• order_id: ID de pedido específico para operações de recuperação/atualização
• cursor: Cursor de paginação para resultados de pesquisa

Armadilhas:

• location_ids é obrigatório para SEARCH_ORDERS; obtenha os IDs de LIST_LOCATIONS primeiro
• Os estados do pedido incluem: OPEN, COMPLETED, CANCELED, DRAFT
• UPDATE_ORDER requer o campo version atual para evitar conflitos
• Os resultados da pesquisa são paginados; siga cursor até que esteja ausente

3. Gerenciar Localizações

Quando usar: O usuário deseja visualizar locais de negócios ou obter detalhes de localização

Sequência de ferramentas:

1. SQUARE_LIST_LOCATIONS - Listar todos os locais de negócios [Obrigatório]

Parâmetros principais:

• Nenhum parâmetro obrigatório; retorna todos os locais acessíveis
• A resposta inclui id, name, address, status, timezone

Armadilhas:

• IDs de localização são necessários para a maioria das outras operações do Square (pedidos, pagamentos)
• Sempre armazene em cache os IDs de localização após a primeira recuperação para evitar chamadas redundantes
• Locais inativos ainda podem aparecer nos resultados; verifique o campo status

4. Gerenciamento de Faturas

Quando usar: O usuário deseja listar, visualizar ou cancelar faturas

Sequência de ferramentas:

1. SQUARE_LIST_LOCATIONS - Obter ID de localização para filtragem [Pré-requisito]
2. SQUARE_LIST_INVOICES - Listar faturas para uma localização [Obrigatório]
3. SQUARE_GET_INVOICE - Obter informações detalhadas da fatura [Opcional]
4. SQUARE_CANCEL_INVOICE - Cancelar uma fatura agendada ou não paga [Opcional]

Parâmetros principais:

• location_id: Obrigatório para listar faturas
• invoice_id: Obrigatório para operações de obter/cancelar
• cursor: Cursor de paginação para resultados da lista
• limit: Número de resultados por página

Armadilhas:

• location_id é obrigatório para LIST_INVOICES; resolva via LIST_LOCATIONS primeiro
• Apenas faturas SCHEDULED, UNPAID ou PARTIALLY_PAID podem ser canceladas
• CANCEL_INVOICE requer o version da fatura para evitar condições de corrida
• Faturas canceladas não podem ser reativadas

Padrões Comuns

Resolução de ID

Nome da localização -> ID da localização:

1. Call SQUARE_LIST_LOCATIONS
2. Find location by name in response
3. Extract id field (e.g., 'L1234ABCD')

Pesquisa de pedido:

1. Chame SQUARE_SEARCH_ORDERS com location_ids e filtros de consulta
2. Extraia order_id dos resultados

…