Documentation
Back to CaptainMCP Overview

Setup & Installation

Learn how to install, configure, and securely connect CaptainMCP to your AI clients and Oracle EPM environments.

1. Installation Prerequisites

CaptainMCP runs locally on your machine or on a centralized server. Before installing, ensure you have the following:

  • Node.js: Version 18.0 or higher.
  • Oracle EPM Connection: The URL endpoint for your Oracle EPM Planning or FCCS environment.
  • AI Client: An MCP-compatible client such as Cursor, Claude Desktop, or NotebookLM.

2. Authentication Configuration

CaptainMCP requires Basic Authentication to securely interact with the Oracle EPM REST API. You will need to configure your local environment variables to store these credentials safely.

EPM_URL=https://epm-tenant.pbcs.us1.oraclecloud.com
EPM_USERNAME=admin@company.com
EPM_PASSWORD=your_secure_password

Note: We strongly recommend using a dedicated service account rather than a personal admin account for production workflows.

3. Connecting to the AI Client

Once CaptainMCP is configured, you need to expose it to your AI client. Depending on your tool of choice, the configuration will vary:

  • Cursor / Claude Desktop: Add the path to the CaptainMCP executable or Node.js script in your MCP settings file (e.g., `mcp_config.json`).
  • NotebookLM: Utilize the provided MCP configuration script to establish a local tunnel or direct command-line integration, allowing NotebookLM to query the EPM APIs during research sessions.