Sheet Best MCP
Conecte assistentes de IA ao Google Sheets por meio de ferramentas com escopo definido para descobrir conexões e ler, adicionar, atualizar ou excluir linhas.
Documentação
O Model Context Protocol (MCP) é uma forma padrão para assistentes de IA usarem ferramentas externas. O Sheet Best fornece um servidor MCP remoto para que um assistente compatível possa descobrir suas conexões do Google Sheets, inspecionar suas permissões e trabalhar com linhas usando as regras de acesso que você já configurou no Sheet Best.
[!-secondary] -secondary Disponibilidade
O MCP é destinado aos planos Personal e superiores. Como oferta introdutória, também está disponível no Tiny por tempo limitado. Esta versão ainda não aplica restrições de acesso ao MCP por plano.
O que seu assistente pode fazer
Após conectar um cliente compatível com MCP, ele pode:
- listar suas conexões do Sheet Best e seus URLs de API;
- criar uma conexão a partir de um URL do Google Sheets;
- verificar se uma planilha pode ser lida ou editada;
- listar, filtrar e consultar linhas;
- adicionar, atualizar, substituir ou excluir linhas quando você solicitar explicitamente;
- verificar seu plano e a cota de solicitações restante.
O MCP complementa a API REST do Sheet Best. Use o MCP quando um assistente de IA deve escolher e chamar ferramentas por você. Use o início rápido da API REST ao criar um aplicativo que envia solicitações HTTP diretamente.
Um servidor padrão, com um URL direto opcional
Para a maioria dos clientes, configure apenas o endpoint da conta mostrado em Configurações → Integrações → Assistentes de IA · MCP. O token identifica sua conta, e o assistente passa um ID de conexão ao usar uma ferramenta de planilha.
| Endpoint | Escopo | Quando usar |
|---|---|---|
| Endpoint da conta | Todas as conexões habilitadas para MCP na sua conta | Padrão. Liste ou crie conexões e use ferramentas de planilha a partir de um servidor configurado. |
| Endpoint de conexão direta | Uma conexão do Sheet Best | Opcional. Use quando quiser uma configuração de cliente focada em uma única planilha. |
Cada página de conexão mostra seu endpoint MCP direto opcional. Ambos os tipos de endpoint usam o mesmo token MCP e aplicam as mesmas configurações de conexão.
O que você precisa
- Uma conta do Sheet Best com acesso ao MCP disponível.
- Um Google Sheet com uma linha de cabeçalho válida. Consulte Prepare sua planilha.
- Um cliente MCP remoto que possa enviar um token de portador com segurança.
- Acesso de edição do Google e métodos de escrita habilitados se o assistente precisar alterar linhas.
Como o acesso é controlado
O MCP segue as mesmas regras de conexão da API REST:
- Sua conta e a conexão individual devem permitir acesso ao MCP.
- Os endpoints de conta e diretos aceitam seu token MCP do Sheet Best.
- Propriedade da conexão, métodos permitidos, recursos do plano, permissões do Google Sheets, cota, regras de origem e regras de IP continuam valendo.
- Ferramentas que uma conexão não pode usar são omitidas da lista de ferramentas dela.
- Operações bem-sucedidas de linhas e informações de planilha consomem a mesma cota mensal de solicitações que seus equivalentes na REST. Ferramentas de permissão, limite e conta não consomem.