Conectar assistentes de IA com MCP
O Protocolo de Contexto de Modelo (MCP) é um padrão que permite a assistentes de IA usar ferramentas externas. O Sheet Best oferece um servidor MCP remoto para que um assistente compatível descubra suas conexões do Google Sheets, consulte as permissões e trabalhe com linhas respeitando as regras de acesso que você já configurou no Sheet Best.
O MCP é destinado aos planos Personal e superiores. Como oferta de lançamento, ele 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
Depois de conectar um cliente compatível com MCP, ele pode:
- listar suas conexões do Sheet Best e suas URLs de API;
- criar uma conexão a partir de uma 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;
- consultar seu plano e as requisições restantes.
O MCP complementa a API REST do Sheet Best. Use MCP quando quiser que um assistente de IA escolha e chame ferramentas por você. Use o guia rápido da API REST ao desenvolver um aplicativo que envie requisições HTTP diretamente.
Um servidor padrão e uma URL direta opcional
Para a maioria dos clientes, configure apenas o Account endpoint (Endpoint da conta) exibido nas configurações da conta. O token identifica sua conta e o assistente envia um ID de conexão ao usar uma ferramenta de planilha.
| Endpoint | Escopo | Quando usar |
|---|---|---|
| Endpoint da conta | Todas as conexões da conta com MCP ativado | Opção padrão. Liste ou crie conexões e use ferramentas de planilha em um único servidor configurado. |
| Endpoint direto da conexão | Uma conexão do Sheet Best | Opcional. Use para uma configuração de cliente focada em uma única planilha. |
Cada página de conexão mostra seu Direct MCP endpoint (Endpoint MCP direto) opcional. Os dois tipos de endpoint usam o mesmo token MCP e aplicam as mesmas configurações da conexão.
O que você precisa
- Uma conta do Sheet Best com acesso ao MCP disponível.
- Uma planilha do Google Sheets com uma linha de cabeçalho válida. Consulte preparar 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 gravação ativados 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 cada conexão devem permitir acesso ao MCP.
- Os endpoints da conta e diretos aceitam seu token MCP do Sheet Best.
- A propriedade da conexão, os métodos permitidos, os recursos do plano, as permissões do Google Sheets, a cota e as regras de origem e IP continuam sendo aplicados.
- As ferramentas que uma conexão não pode usar são omitidas da lista de ferramentas.
- Operações bem-sucedidas em linhas e informações da planilha consomem a mesma cota mensal de requisições que seus equivalentes REST. Ferramentas de permissões, limites e conta não consomem cota.