Xata MCP server

Servidor MCP

Conecte o Cursor, Claude, VS Code e outros clientes MCP ao Xata

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

O que é o servidor Xata MCP?

• Um servidor MCP hospedado que é executado 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 Streamable HTTP.

URL do servidor:

https://api.xata.tech/mcp

O servidor usa o transporte Streamable HTTP. Não há endpoint SSE nem versão local (npm) do servidor.

Autenticação

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

Método	Use quando	Requisito do cliente
OAuth	Uso interativo em um editor/chat	Suporte a OAuth MCP (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 solicita que você faça login na sua conta Xata e aprove o acesso. Os tokens são de curta duração e têm escopo limitado ao servidor MCP.

Chave de API

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

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

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 de segredos do seu cliente — nunca a envie para o controle de código-fonte.

Configure seu cliente MCP

Cursor

[!TIP]

O Cursor oferece um deep link para configuração rápida via OAuth:

Adicionar ao Cursor

Como alternativa, 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:

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

4. Salve o arquivo. O Cursor solicitará que você se autentique — siga o fluxo no 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 no navegador para se 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.

Como alternativa, adicione-o à sua configuração manualmente:

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

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

Claude (web e desktop)

[!TIP]

Abra a caixa de diálogo de conector personalizado do Claude com os detalhes do Xata preenchidos:

Conectar o Xata ao Claude

Revise e confirme o conector no Claude, depois autentique-se com o Xata.

Como alternativa, adicione o Xata como um conector personalizado manualmente:

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.

[!NOTE]

Conectores personalizados que usam 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 mais detalhes.

ChatGPT

Conecte o ChatGPT ao Xata usando um conector personalizado:

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

https://api.xata.tech/mcp

3. Escolha OAuth para autenticação e conclua o fluxo de autorização quando solicitado.
4. Em cada chat em que você quiser usar o Xata, clique no botão + e ative o conector Xata em Add sources.

Codex CLI

Adicione o servidor Xata:

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

[!NOTE]

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

Autentique-se com o Xata usando escopos OAuth explícitos:

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

Conclua a autorização no navegador. O escopo offline_access permite que o Codex renove sua sessão do Xata sem exigir outra autorização no navegador.

Em seguida, inicie o codex, execute /mcp e verifique se xata está conectado e autenticado.

Antigravity CLI

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

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

Para habilitar o Xata apenas em um projeto, use .agents/mcp_config.json na raiz desse projeto.

Inicie o agy e insira /mcp. No MCP Manager, use Authenticate para xata e siga as instruções para concluir o OAuth.

OpenCode

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

{
  "$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 o amp — você deverá ser solicitado a se 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:

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

3. Salve o arquivo e clique em Refresh na barra lateral do Cascade. Conclua 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:

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

2. O Zed solicitará que você se 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 aba 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"
    }
  }
}

[!NOTE]

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

Outros clientes MCP

Qualquer cliente MCP pode se conectar se suportar:

• Servidores MCP remotos via Streamable HTTP (não SSE)
• OAuth com registro dinâmico de cliente, ou cabeçalhos HTTP personalizados para autenticação com 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, peça ao seu assistente:

Use o servidor Xata MCP para encontrar a operação da API REST para listar branches.

O assistente deve chamar search_operations com {"query":"list branches"} e retornar a operação listBranches, que pode ser invocada por meio de call_read_operation. Se fizer isso, a conexão está funcionando.

Ferramentas disponíveis

O servidor Xata MCP expõe as seguintes ferramentas:

Ferramenta	Descrição
search_operations	Encontra uma operação da API REST do Xata por intenção (por exemplo, "listar branches" ou "convidar membro").
describe_operation	Retorna os parâmetros e os esquemas de requisição/resposta de 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; instruções que alteram dados exigem tanto write=true quanto confirm=true.
describe_schema	Lista as tabelas e colunas de um branch.
list_skills	Lista as skills disponíveis do Xata — fluxos de trabalho guiados para tarefas comuns de várias etapas.
get_skill	Lê as instruções de uma skill específica.
search_xata	Pesquisa na 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 são de curta duração e podem ser revogados desconectando o servidor no seu cliente.
• Para automação, use uma chave de API dedicada e faça sua rotação regularmente.
• Algumas ferramentas podem modificar seus dados: call_write_operation e call_destructive_operation podem alterar ou excluir recursos (a última requer confirm=true), e run_sql pode modificar dados quando chamada com write=true e confirm=true. Revise as ações que seu assistente propõe antes de aprová-las e mantenha um humano no loop 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.

A autenticação mostra "Client not found" no navegador. Seu cliente MCP pode ter um registro OAuth salvo que não está mais disponível no servidor de autenticação do Xata. Dependendo do cliente, remover e adicionar novamente o servidor MCP pode manter esse registro intacto. Limpe o registro OAuth salvo para o Xata no seu cliente, depois reinicie o servidor Xata MCP e autentique-se novamente para permitir um novo registro.

Por exemplo, no VS Code:

1. Abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P).
2. Execute Authentication: Remove Dynamic Authentication Providers.
3. Selecione o provedor associado ao Xata, deixando os provedores não relacionados inalterados.
4. Reinicie o servidor Xata MCP e conclua a autenticação novamente.

O servidor se conecta, mas nenhuma ferramenta aparece. Certifique-se de que você concluiu a etapa de autenticação — a maioria das ferramentas exige 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 se conectar de forma alguma. Confirme que a URL é exatamente https://api.xata.tech/mcp e que seu cliente suporta Streamable HTTP. 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 estrutura do JSON difere entre clientes (mcpServers vs servers vs context_servers, url vs serverUrl) — e verifique os logs do cliente. A maioria dos clientes exige uma reinicialização completa após alterações na configuração.

Esta documentação é criada e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.