Xata MCP server

Ir para o conteúdo principal

O Xata MCP server permite que assistentes e agentes de IA interajam com suas organizações, projetos e branches do Xata usando o Model Context Protocol (MCP).

​O que é o Xata MCP server?

• Um servidor MCP hospedado que roda junto com a API do Xata — não há nada para instalar ou executar localmente.
• Autenticado via OAuth no seu navegador, ou com uma chave de API do Xata para ambientes headless.
• Acessível a partir de qualquer cliente MCP que suporte servidores remotos via HTTP Transmissível.

URL do servidor:

https://api.xata.tech/mcp

O servidor usa o transporte HTTP Transmissível. Não há endpoint SSE e não há versão local (npm) do servidor.

​Autenticação

O servidor MCP suporta dois métodos de autenticação:

Método	Quando usar	Requisito do cliente
OAuth	Uso interativo em um editor/chat	Suporte a MCP OAuth (registro dinâmico de cliente)
Chave de API	Automação, CI, agentes headless	Suporte a cabeçalhos HTTP personalizados

​OAuth

Com clientes compatíveis com OAuth, você só precisa da URL do servidor. Quando seu cliente se conecta pela primeira vez, ele se registra no Xata, abre uma janela do navegador e pede que você faça login na sua conta Xata e aprove o acesso. Os tokens têm vida curta e escopo limitado ao servidor MCP.

​Chave de API

Clientes que suportam cabeçalhos personalizados podem autenticar com uma chave de API do Xata:

Authorization: Bearer YOUR_XATA_API_KEY

Crie uma chave de API dedicada para acesso MCP em vez de reutilizar uma chave existente. Armazene-a em uma variável de ambiente ou no armazenamento secreto do seu cliente — nunca a inclua no controle de código-fonte.

​Configure seu cliente MCP

​Cursor

O Cursor oferece um link direto para configuração rápida de OAuth:Adicionar ao Cursor

Alternativamente, você pode adicioná-lo manualmente:

1. Abra a paleta de comandos e procure por “Cursor Settings”.
2. Em Tools & MCP, clique em New MCP Server.
3. Adicione o servidor Xata ao arquivo de configuração que abrir:

.cursor/mcp.json

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

4. Salve o arquivo. O Cursor solicitará que você autentique — siga o fluxo do navegador e aprove o acesso à sua conta Xata.

​Claude Code

Adicione o servidor a partir do seu terminal:

claude mcp add --transport http xata https://api.xata.tech/mcp

Em seguida, inicie o Claude Code e execute o comando de barra /mcp. Selecione o servidor xata e siga as instruções do navegador para autenticar. Para usar uma chave de API em vez de OAuth (por exemplo, em CI):

claude mcp add --transport http xata https://api.xata.tech/mcp
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

​VS Code

Servidores MCP no VS Code exigem as extensões GitHub Copilot e GitHub Copilot Chat.

1. Abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P).
2. Execute MCP: Add Server e escolha HTTP.
3. Insira https://api.xata.tech/mcp como a URL e xata como o nome.

Alternativamente, adicione-o à sua configuração manualmente:

.vscode/mcp.json

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Inicie o servidor a partir de MCP: List Servers e permita que ele autentique quando solicitado.

​Claude (web e desktop)

Adicione o Xata como um conector personalizado:

1. Vá para Settings → Connectors.
2. Clique em Add custom connector.
3. Insira https://api.xata.tech/mcp como a URL do servidor e clique em Add.
4. Siga as instruções para fazer login com sua conta Xata.

Conectores personalizados usando MCP remoto não estão disponíveis em todos os planos do Claude e podem exigir que um proprietário da organização os adicione em planos de equipe. Consulte a documentação do Claude para obter detalhes.

​ChatGPT

Conecte o ChatGPT ao Xata usando um conector personalizado:

1. No ChatGPT, vá para Settings → Connectors → Advanced settings e habilite o Developer mode.
2. Na guia Connectors, crie um novo conector com a URL do servidor:

https://api.xata.tech/mcp

3. Escolha OAuth para autenticação e complete o fluxo de autorização quando solicitado.
4. Em cada chat onde deseja usar o Xata, clique no botão + e habilite o conector Xata em Add sources.

​Codex CLI

Adicione o servidor Xata:

codex mcp add xata --url https://api.xata.tech/mcp

O comando add pode abrir um navegador e relatar um erro OAuth. Se isso acontecer, continue com o comando de login abaixo; a entrada do servidor xata já foi salva.

Autentique-se no Xata usando escopos OAuth explícitos:

codex mcp login xata --scopes mcp-client,offline_access

Complete a autorização no navegador. O escopo offline_access permite que o Codex atualize sua sessão Xata sem exigir outra autorização do navegador. Em seguida, inicie codex, execute /mcp e verifique se xata está conectado e autenticado.

​Antigravity CLI

Adicione o Xata à sua configuração MCP global:

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Para habilitar o Xata apenas para um projeto, use .agents/mcp_config.json na raiz desse projeto. Inicie agy e digite /mcp. No Gerenciador MCP, use Authenticate para xata e siga as instruções para completar o OAuth.

​OpenCode

Adicione o servidor Xata ao seu arquivo de configuração do OpenCode:

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Em seguida, autentique-se a partir do seu terminal:

opencode mcp auth xata

​Amp

Adicione o servidor a partir do seu terminal:

amp mcp add xata https://api.xata.tech/mcp

Em seguida, inicie amp — você deve ser solicitado a autenticar no navegador. Execute /mcp list tools para confirmar que o servidor está conectado.

​Windsurf

1. No Windsurf, abra o painel Cascade e clique no ícone MCP (martelo), depois em Configure para abrir o arquivo de configuração bruto (~/.codeium/windsurf/mcp_config.json).
2. Adicione a entrada do servidor Xata:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

3. Salve o arquivo e clique em Refresh na barra lateral Cascade. Complete o fluxo OAuth quando a janela do navegador abrir.

​Zed

1. Abra Settings → AI → MCP Servers e clique em Add Server → Add Remote Server, ou edite seu arquivo de configurações diretamente:

settings.json

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

2. O Zed solicitará que você autentique no servidor usando o fluxo OAuth MCP padrão.

​Cline

1. Abra o Cline no VS Code e clique no ícone MCP Servers.
2. Na guia Remote Servers, insira xata como o nome, https://api.xata.tech/mcp como a URL e escolha Streamable HTTP como o transporte. Ou edite o JSON de configuração diretamente:

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

O tipo de transporte deve ser streamableHttp (camelCase). Omiti-lo faz com que o Cline recorra ao transporte SSE legado, que o Xata MCP server não suporta.

​Outros clientes MCP

Qualquer cliente MCP pode se conectar se suportar:

• Servidores MCP remotos via HTTP Transmissível (não SSE)
• OAuth com registro dinâmico de cliente, ou cabeçalhos HTTP personalizados para autenticação por chave de API

Consulte a documentação do seu cliente para saber onde configurar servidores MCP remotos e use https://api.xata.tech/mcp como a URL.

​Verifique a conexão

Após conectar, pergunte ao seu assistente:

Use o Xata MCP server para me dizer como estou autenticado.

O assistente deve chamar a ferramenta user_info e retornar sua identidade de usuário (ou a identidade da chave de API, se você autenticou com uma chave). Se isso acontecer, a conexão está funcionando.

​Ferramentas disponíveis

O Xata MCP server expõe as seguintes ferramentas:

Ferramenta	Descrição
user_info	Retorna a identidade do chamador autenticado — seu ID de usuário e e-mail para OAuth, ou o ID da chave de API.
search_operations	Encontra uma operação da API REST do Xata por intenção (por exemplo, “list branches” ou “invite member”).
describe_operation	Retorna os parâmetros e esquemas de solicitação/resposta para uma operação específica.
call_read_operation	Invoca uma operação somente leitura da API REST do Xata.
call_write_operation	Invoca uma operação da API REST do Xata que cria ou atualiza dados.
call_destructive_operation	Invoca uma operação da API REST do Xata que destrói dados ou revoga acesso. Requer confirm=true.
run_sql	Executa SQL em um branch. Somente leitura por padrão; passe write=true para executar instruções que alteram dados.
describe_schema	Lista as tabelas e colunas de um branch.
list_skills	Lista as habilidades Xata disponíveis — fluxos de trabalho guiados para tarefas comuns de várias etapas.
get_skill	Lê as instruções para uma habilidade específica.
search_xata	Pesquisa a documentação do Xata.
query_docs_filesystem_xata	Lê páginas da documentação do Xata por caminho.

​Segurança

• Prefira OAuth para clientes interativos; os tokens têm vida curta e podem ser revogados desconectando o servidor no seu cliente.
• Para automação, use uma chave de API dedicada e faça a rotação regularmente.
• Algumas ferramentas podem modificar seus dados: call_write_operation e call_destructive_operation podem alterar ou excluir recursos (este último requer confirm=true), e run_sql pode alterar dados quando chamado com write=true. Revise as ações que seu assistente propõe antes de aprová-las e mantenha um humano no circuito para qualquer gravação ou exclusão.

​Solução de problemas

A autenticação continua falhando ou entra em loop. Remova o servidor Xata do seu cliente, reinicie o cliente e adicione o servidor novamente para acionar um novo fluxo OAuth. O servidor conecta, mas nenhuma ferramenta aparece. Certifique-se de ter concluído a etapa de autenticação — a maioria das ferramentas requer uma sessão válida antes de aparecer. Execute novamente o fluxo de autenticação do seu cliente e atualize sua lista de ferramentas. Consulte Ferramentas disponíveis para o conjunto completo. Seu cliente não consegue conectar de forma alguma. Confirme se a URL é exatamente https://api.xata.tech/mcp e se seu cliente suporta HTTP Transmissível. Clientes somente SSE não são suportados. O servidor não aparece no seu cliente. Verifique a sintaxe do arquivo de configuração MCP do cliente — a forma JSON difere entre clientes (mcpServers vs servers vs context_servers, url vs serverUrl) — e verifique os logs do cliente. A maioria dos clientes requer uma reinicialização completa após alterações de configuração.

Esta página foi útil?

Anterior

Organizações

Próximo