Automação do Coda via Rube MCP

Automatize operações de documentos e dados do Coda através do toolkit Coda do Composio via Rube MCP.

Pré-requisitos

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

Configuração

Obtenha o 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 toolkit coda
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Coda
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Pesquisar e Navegar Documentos

Quando usar: O usuário deseja encontrar, listar ou inspecionar documentos do Coda

Sequência de ferramentas:

1. CODA_SEARCH_DOCS ou CODA_LIST_AVAILABLE_DOCS - Encontrar documentos [Obrigatório]
2. CODA_RESOLVE_BROWSER_LINK - Resolver um URL do Coda para IDs de documento/página/tabela [Alternativa]
3. CODA_LIST_PAGES - Listar páginas dentro de um documento [Opcional]
4. CODA_GET_A_PAGE - Obter detalhes de uma página específica [Opcional]

Parâmetros chave:

• query: Termo de pesquisa para encontrar documentos
• isOwner: Filtro para documentos de propriedade do usuário
• docId: ID do documento para operações de página
• pageIdOrName: Identificador ou nome da página
• url: URL do navegador para operações de resolução

Armadilhas:

• IDs de documentos são strings alfanuméricas (ex: 'AbCdEfGhIj')
• CODA_RESOLVE_BROWSER_LINK é a melhor maneira de converter um URL do Coda para IDs de API
• Nomes de páginas podem não ser únicos dentro de um documento; prefira IDs de página
• Os resultados da pesquisa incluem documentos compartilhados com o usuário, não apenas documentos de propriedade

2. Trabalhar com Tabelas e Dados

Quando usar: O usuário deseja ler, escrever ou consultar dados de tabelas

Sequência de ferramentas:

1. CODA_LIST_TABLES - Listar tabelas em um documento [Pré-requisito]
2. CODA_LIST_COLUMNS - Obter definições de colunas para uma tabela [Pré-requisito]
3. CODA_LIST_TABLE_ROWS - Listar todas as linhas com filtros opcionais [Obrigatório]
4. CODA_SEARCH_ROW - Pesquisar linhas específicas por consulta [Alternativa]
5. CODA_GET_A_ROW - Obter uma linha específica por ID [Opcional]
6. CODA_UPSERT_ROWS - Inserir ou atualizar linhas em uma tabela [Opcional]
7. CODA_GET_A_COLUMN - Obter detalhes de uma coluna específica [Opcional]

Parâmetros chave:

• docId: ID do documento que contém a tabela
• tableIdOrName: Identificador ou nome da tabela
• query: Consulta de filtro para pesquisa de linhas
• rows: Array de objetos de linha para operações de upsert
• keyColumns: IDs de coluna usados para correspondência durante o upsert
• sortBy: Coluna para ordenar os resultados
• useColumnNames: Usar nomes de colunas em vez de IDs nos dados da linha

Armadilhas:

• Nomes de tabelas podem conter espaços; codifique em URL se necessário
• CODA_UPSERT_ROWS insere se não houver correspondência em keyColumns, atualiza se houver correspondência
• keyColumns deve referenciar colunas que tenham valores únicos para upserts confiáveis
• IDs de coluna são diferentes de nomes de coluna; liste as colunas primeiro para mapear nomes para IDs
• useColumnNames: true permite o uso de nomes legíveis nos dados da linha
• Os valores dos dados da linha devem corresponder ao tipo da coluna (texto, número, data, etc.)

3. Gerenciar Fórmulas

Quando usar: O usuário deseja listar ou avaliar fórmulas em um documento

Sequência de ferramentas:

1. CODA_LIST_FORMULAS - Listar todas as fórmulas nomeadas em um documento [Obrigatório]
2. CODA_GET_A_FORMULA - Obter o valor atual de uma fórmula específica [Opcional]

Parâmetros chave:

• docId: ID do documento
• formulaIdOrName: Identificador ou nome da fórmula

Armadilhas:

• Fórmulas são cálculos nomeados definidos no documento
• Os valores das fórmulas são computados no lado do servidor; os resultados refletem o estado atual
• Nomes de fórmulas diferenciam maiúsculas de minúsculas

4. Exportar Conteúdo do Documento

Quando usar: O usuário deseja exportar um documento ou página para HTML ou Markdown

Sequência de ferramentas:

1. CODA_BEGIN_CONTENT_EXPORT - Iniciar um trabalho de exportação [Obrigatório]
2. CODA_CONTENT_EXPORT_STATUS - Consultar o status da exportação até a conclusão [Obrigatório]

Parâmetros chave:

• docId: ID do documento a ser exportado
• outputFormat: Formato de exportação ('html' ou 'markdown')
• pageIdOrName: Página específica a ser exportada (opcional, omita para o documento completo)
• requestId: ID da solicitação de exportação para consulta de status

Armadilhas:

• A exportação é assíncrona; consulte o status até que status seja 'complete'
• Documentos grandes podem levar um tempo considerável para exportar
• O URL de exportação na resposta completa é temporário; baixe prontamente

…