Maindex Smart Memory Service

Conecte sua ferramenta de IA ao Maindex

O Maindex usa o Model Context Protocol (MCP) para que qualquer cliente de IA compatível possa ler e escrever memórias. A maioria dos clientes suporta OAuth e solicitará que você faça login automaticamente. Basta fornecer a URL abaixo. Escolha sua ferramenta para instruções passo a passo.

Trabalhando em equipe? A memória da equipe usa a mesma configuração MCP que a sua memória pessoal. Não é necessário configurar uma segunda conexão. Guia de Equipes

Qual é a diferença?

https://maindex.io/mcp

Procurando por plugins?

Os plugins do Maindex para Cursor, Claude Code, Hermes, OpenClaw, Gemini CLI e ChatGPT incluem o servidor MCP com regras, habilidades e um agente Arquivista selecionados. Ver Plugins e Aplicativos →

Editores de Código

Desktop e CLI

Auto-hospedado

Cursor

Editor de código nativo de IA com suporte MCP integrado.

1Abra ou crie sua configuração MCP

O Cursor lê servidores MCP de um arquivo JSON. Use um arquivo de nível de projeto para configuração por repositório, ou um arquivo global para todos os espaços de trabalho.

Escopo	Caminho
Projeto	.cursor/mcp.json
Global	~/.cursor/mcp.json

Basta fornecer a URL. O Cursor abrirá uma janela do navegador para você fazer login via OAuth.

{
  "mcpServers": {
    "maindex": {
      "type": "streamableHttp",
      "url": "https://maindex.io/mcp"
    }
  }
}

Se o OAuth não estiver disponível no seu ambiente, use uma chave de API do seu painel como alternativa.

{
  "mcpServers": {
    "maindex": {
      "type": "streamableHttp",
      "url": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3Reinicie o Cursor

Saia completamente e reabra o Cursor. Os servidores MCP são carregados na inicialização. Você pode verificar a conexão em Configurações → Ferramentas e MCP.

Documentação MCP do Cursor →

Claude Desktop

O aplicativo de desktop da Anthropic para Claude.

1Abra o arquivo de configuração

Vá para Configurações → Desenvolvedor → Editar Configuração, ou abra o arquivo diretamente:

SO	Caminho
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Basta fornecer a URL. O Claude Desktop abrirá uma janela do navegador para você fazer login via OAuth.

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp"
    }
  }
}

Se o OAuth não estiver disponível no seu ambiente, use uma chave de API do seu painel como alternativa.

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3Reinicie o Claude Desktop

Saia completamente e reabra o aplicativo. Procure o ícone de martelo na área de entrada do chat para confirmar que as ferramentas MCP estão carregadas.

Documentação MCP da Anthropic →

Claude Code

CLI de agente da Anthropic para o terminal.

1Adicione via CLI

Basta fornecer a URL. O Claude Code abrirá um navegador para você fazer login via OAuth.

claude mcp add --transport http maindex https://maindex.io/mcp

Isso salva no escopo local por padrão (projeto atual). Adicione --scope user para todos os projetos, ou --scope project para commit de um .mcp.json compartilhado.

Sessões remotas SSH

O OAuth requer um navegador local. Se você estiver usando o Claude Code via SSH, use o método de Chave de API em vez disso.

Use uma chave de API do seu painel quando o OAuth não estiver disponível (por exemplo, sessões remotas SSH).

claude mcp add --transport http --header "X-API-Key: YOUR_API_KEY" maindex https://maindex.io/mcp

Isso salva no escopo local por padrão (projeto atual). Adicione --scope user para todos os projetos, ou --scope project para commit de um .mcp.json compartilhado.

2Verifique

Liste seus servidores configurados para confirmar:

claude mcp list

Documentação MCP do Claude Code →

ChatGPT

O aplicativo de desktop ChatGPT da OpenAI com conectores MCP.

1Ative o Modo Desenvolvedor

Abra Configurações → Aplicativos e Conectores → Configurações avançadas e ative o Modo Desenvolvedor.

2Crie um conector

Clique em Criar em Aplicativos e Conectores e preencha:

Campo	Valor
URL do conector	https://maindex.io/mcp
Nome	Maindex
Descrição	Memória de longo prazo para agentes de IA

O ChatGPT lidará com a autenticação via OAuth automaticamente. Você será solicitado a fazer login ao usar o conector pela primeira vez.

3Ative em conversas

Em qualquer chat, ative o conector Maindex na área de composição para dar ao ChatGPT acesso às suas memórias.

Documentação MCP da OpenAI →

Windsurf

Editor de código com IA da Codeium.

1Abra a configuração MCP

Use a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P) e pesquise por "Windsurf: Configurar Servidores MCP", ou edite o arquivo diretamente:

SO	Caminho
macOS / Linux	~/.codeium/windsurf/mcp_config.json
Windows	%USERPROFILE%\.codeium\windsurf\mcp_config.json

Basta fornecer a URL. O Windsurf abrirá uma tela de consentimento do navegador para você fazer login via OAuth.

{
  "mcpServers": {
    "maindex": {
      "serverUrl": "https://maindex.io/mcp"
    }
  }
}

Se o OAuth não estiver disponível no seu ambiente, use uma chave de API do seu painel como alternativa.

{
  "mcpServers": {
    "maindex": {
      "serverUrl": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3Reinicie o Windsurf

Saia completamente e reabra o Windsurf. Verifique o ícone de martelo no painel de Chat para confirmar que o servidor está conectado.

Documentação MCP do Windsurf →

Gemini CLI

Interface de linha de comando do Google para Gemini.

Recomendado: Instale a extensão Maindex

A extensão Maindex para Gemini CLI inclui o servidor MCP com um arquivo de contexto (GEMINI.md), comandos de barra e comportamento de Arquivista. Clone de: git clone https://github.com/maindexapp/gemini-plugin.git

Se você preferir uma configuração manual apenas com MCP, sem o conteúdo da extensão, siga os passos abaixo.

Basta fornecer a URL. O Gemini CLI abrirá um navegador para você fazer login via OAuth.

gemini mcp add --transport http maindex https://maindex.io/mcp

Isso salva na sua configuração de nível de projeto em .gemini/settings.json. Para configuração global, edite ~/.gemini/settings.json diretamente.

Se o OAuth não estiver disponível no seu ambiente, use uma chave de API do seu painel como alternativa.

gemini mcp add --transport http --header "X-API-Key: YOUR_API_KEY" maindex https://maindex.io/mcp

Ou edite a configuração JSON diretamente:

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Documentação do Gemini CLI →

Hermes

Agente Hermes com integração nativa de provedor de memória.

Recomendado: Instale o plugin Maindex

O plugin Maindex para Hermes conecta-se à API Expert com ganchos de ciclo de vida (prefetch, sync, espelhamento de memória) e habilidades incluídas.

1Instale o plugin

hermes plugins install maindexapp/hermes-plugin

Isso instala o plugin Expert automaticamente (nenhuma configuração de URL MCP é necessária).

2Crie uma chave de API

Crie uma chave nas configurações do painel em Chaves de API.

3Configure o Hermes

echo "MAINDEX_API_KEY=your-key" >> ~/.hermes/.env hermes config set memory.provider maindex

Substitua your-key pela chave do seu painel.

Guia completo de configuração do Hermes → Repositório GitHub →

Google Antigravity

IDE orientada a agentes do Google para desenvolvimento em linguagem natural.

1Abra a configuração MCP

Clique nos três pontos (…) no canto superior direito do Antigravity e selecione Servidores MCP. Clique em Gerenciar Servidores MCP → Ver configuração bruta para abrir o editor JSON.

Basta fornecer a URL. O Antigravity lidará com a autenticação OAuth automaticamente.

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp"
    }
  }
}

Se o OAuth não estiver disponível no seu ambiente, use uma chave de API do seu painel como alternativa.

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3Atualize

Use o botão de atualização no painel de Servidores MCP para verificar a conexão. As ferramentas do Maindex aparecerão quando você usar o prompt @.

Google Antigravity →

LM Studio

Execute modelos locais com suporte a ferramentas MCP.

1Abra a configuração MCP

O LM Studio lê servidores MCP de um arquivo JSON. Abra-o via o editor MCP no aplicativo, ou edite o arquivo diretamente:

SO	Caminho
macOS / Linux	~/.lmstudio/mcp.json
Windows	%USERPROFILE%\.lmstudio\mcp.json

O LM Studio ainda não suporta OAuth para servidores MCP remotos, então uma chave de API é necessária. Crie uma no seu painel e cole abaixo.

{
  "mcpServers": {
    "maindex": {
      "url": "https://maindex.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

3Verifique

O LM Studio recarrega automaticamente quando você salva mcp.json. Certifique-se de estar usando um modelo com capacidade de ferramentas (Llama 3.1+, Mistral, Qwen 2.5, etc.) para que as ferramentas MCP apareçam.

Documentação MCP do LM Studio →

Open WebUI

Interface web auto-hospedada para Ollama e outros backends.

1Abra as configurações de Ferramentas Externas

Vá para Configurações de Administrador → Ferramentas Externas. Requer Open WebUI v0.6.31 ou posterior.

2Adicione o servidor Maindex

Insira a URL e selecione OAuth 2.1 como tipo de autenticação. O Open WebUI lidará com o fluxo OAuth automaticamente.

Campo	Valor
URL do servidor	https://maindex.io/mcp
Tipo	MCP (Streamable HTTP)
Autenticação	OAuth 2.1

Se o OAuth não estiver disponível, crie uma chave de API no seu painel e use-a como token Bearer.

Campo	Valor
URL do servidor	https://maindex.io/mcp
Tipo	MCP (Streamable HTTP)
Autenticação	Bearer Token
Token	YOUR_API_KEY

3Ative em conversas

Clique em + (Adicionar Servidor) e ative as ferramentas Maindex em conversas individuais. Nota: ferramentas conectadas via OAuth devem ser ativadas manualmente por conversa e não podem ser definidas como padrão.

Nota sobre Docker

Se o Open WebUI estiver rodando em Docker e você estiver se conectando a uma instância local do Maindex, use http://host.docker.internal:PORT/mcp em vez de localhost. Defina a variável de ambiente WEBUI_SECRET_KEY para evitar erros de token ao reiniciar o contêiner.

Documentação MCP do Open WebUI →

Msty

Aplicativo de IA para desktop com suporte a MCP Toolbox.

1Abra o Toolbox

No Msty, abra o Toolbox e clique em Adicionar Nova Ferramenta.

2Adicione como servidor HTTP

O Msty ainda não suporta OAuth para servidores MCP remotos, então uma chave de API é necessária. Crie uma no seu painel.

Campo	Valor
Tipo	HTTP
URL do servidor MCP	https://maindex.io/mcp
Nome do cabeçalho	X-API-Key
Valor do cabeçalho	YOUR_API_KEY

3Verifique

As ferramentas Maindex devem aparecer no seu Toolbox. Certifique-se de que o Msty Sidecar esteja em execução se você estiver usando o Msty Studio Web.

Documentação do Msty Toolbox →

OpenClaw

Plataforma de agente de IA autônoma de código aberto.

Recomendado: Instale o plugin Maindex

O plugin nativo Maindex para OpenClaw inclui integração MCP com OAuth, habilidades e comportamento de Arquivista. Clone de: git clone https://github.com/maindexapp/openclaw-plugin.git

Se você preferir uma configuração manual apenas com MCP, sem o plugin, pode usar o plugin de ponte da comunidade abaixo.

1Instale o plugin MCP Bridge

Para uma conexão manual sem o plugin nativo Maindex, o plugin da comunidade openclaw-mcp-bridge fornece transporte HTTP Streamable.

Adicione Maindex ao seu ~/.openclaw/openclaw.json:

{
  "plugins": {
    "enabled": true,
    "entries": {
      "openclaw-mcp-bridge": {
        "config": {
          "servers": [
            {
              "name": "maindex",
              "url": "https://maindex.io/mcp",
              "prefix": "maindex",
              "healthCheck": true
            }
          ],
          "timeout": 30000
        }
      }
    }
  }
}

Em seguida, reinicie o gateway:

openclaw gateway restart && openclaw mcp list

3Autenticação

O plugin de ponte passa cabeçalhos para o servidor remoto. Crie uma chave de API no seu painel e configure-a de acordo com a documentação do plugin de ponte.

Documentação MCP do OpenClaw →

Não vê sua ferramenta?

O Maindex funciona com qualquer cliente MCP que suporte Streamable HTTP. Aponte-o para sua URL MCP e autentique via OAuth ou chave de API. Se quiser que adicionemos instruções para sua ferramenta, avise-nos.

Autenticação

OAuth (recomendado): A maioria dos clientes MCP suporta OAuth e solicitará que você faça login via navegador automaticamente. Basta fornecer a URL MCP sem configuração extra. O Maindex publica endpoints de descoberta padrão .well-known/oauth-protected-resource e .well-known/oauth-authorization-server para que os clientes possam encontrar o servidor de autorização por conta própria.

Chave de API (alternativa): Se o seu cliente não suportar OAuth, ou se você estiver em um ambiente headless/remoto sem navegador, crie uma chave de API no seu painel Maindex em Configurações → Chaves de API e passe-a via cabeçalho X-API-Key.