Codex com IDrive® e2 MCP auto-hospedado

O IDrive® e2 MCP conecta seu armazenamento de objetos IDrive® e2 a assistentes e aplicacoes de AI usando o padrao aberto Model Context Protocol (MCP). Ele permite que clientes de AI compativeis acessem e trabalhem com seus dados com seguranca usando linguagem natural, eliminando a necessidade de integracoes personalizadas, scripts ou fluxos de trabalho manuais. Este guia explica como conectar o Codex ao armazenamento IDrive® e2 usando MCP auto-hospedado em maquinas Windows, Linux ou Mac.

Pre-requisitos

  1. Uma conta IDrive® e2 ativa.
  2. Acesso a uma conta Codex.
  3. Node.js 20 ou mais recente

Arquitetura de referencia

IDrive e2 mcp guides

Implantar o pacote MCP do IDrive® e2

  1. Instalar o pacote MCP auto-hospedado
    npm install --global @idrivee2/s3-mcp
    Ou instale em um projeto Node.js:
    npm install @idrivee2/s3-mcp
  2. Execute o agente apos a instalacao:
    idrivee2-s3-mcp
    O servidor inicia em segundo plano e exibe seu ID de processo, URL MCP e arquivo de log. Use a URL MCP padrao para conectar ao Codex.
    http://127.0.0.1:1908/s3

Configurar o Codex para IDrive® e2 MCP

  1. Faca login no Codex e va para Plugins.
    idrive e2 mcp guides
  2. Navigate to Installed and click Setting icon.
    idrive e2 mcp guides
  3. Clique em Add e selecione Add MCP server no menu suspenso.
    idrive e2 mcp guides
  4. Na caixa de dialogo Connect to a custom MCP, informe os seguintes detalhes e clique em Save.
    1. Escolha Streamable HTTP
    2. Nome do conector: IDrive e2
    3. URL do servidor MCP: http://127.0.0.1:1908/s3
    idrive e2 mcp guides
  5. Voce sera redirecionado para o console web do IDrive® e2.
  6. Digite o email e a senha da sua conta IDrive® e2 e clique em Sign in.
    IDrive e2 mcp guides
  7. Defina a duracao do tempo limite da sessao e a permissao de acesso.
    IDrive e2 mcp guides
  8. Depois de autenticado, voce sera redirecionado para o Codex. Agora voce pode usar prompts em linguagem natural para interagir com o armazenamento IDrive® e2.

Conectar o servidor MCP do IDrive® e2 ao Codex CLI

Voce pode conectar o servidor IDrive® e2 Model Context Protocol (MCP) ao Codex CLI usando autenticacao OAuth.

  1. Adicione o servidor MCP do IDrive® e2 executando o comando a seguir.
    codex mcp add idrive-s3 \
    --url http://127.0.0.1:1908/s3
  2. Autentique-se com IDrive® e2
    Apos executar o comando, voce sera redirecionado para a pagina de login do IDrive® e2.
    1. Faca login usando suas credenciais IDrive® e2
    2. Defina a duracao do tempo limite da sessao e a permissao de acesso.
    3. Clique em Authorize para conceder ao Codex acesso a sua conta IDrive® e2.
  3. Apos a autorizacao, voce e redirecionado de volta ao Codex. Agora voce pode comecar a usar as ferramentas MCP do IDrive® e2 no Codex CLI.