Skip to main content

​
Overview

Cline is a powerful VS Code extension that brings AI-powered development capabilities to your editor. By connecting Cline to Oracle MCP Servers, you can interact with Oracle Cloud Infrastructure directly from your development environment.

​
Prerequisites

Before configuring Cline, ensure you have completed:

​
Installation

1

Install Cline Extension

Install the Cline VS Code Extension from the Visual Studio Code marketplace.
2

Open Cline Panel

Once installed, click the Cline extension icon in the VS Code sidebar to open the extension panel.
3

Access MCP Servers

Click the MCP Servers button near the top of the Cline panel.
4

Open Configuration

Select the Installed tab, then click Configure MCP Servers to open the cline_mcp_settings.json file.

​
Configuration

​
Standard Configuration (stdio)

Add your desired MCP servers to the mcpServers object in cline_mcp_settings.json.

​
macOS/Linux

{
  "mcpServers": {
    "oracle-oci-api-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oracle.oci-api-mcp-server@latest"
      ],
      "env": {
        "OCI_CONFIG_PROFILE": "<profile_name>",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}
Replace <profile_name> with the OCI CLI profile you set up during authentication.

​
Windows

Windows configuration follows the same pattern as macOS/Linux. The main difference is path formatting and environment variable syntax. Refer to the Quickstart guide for Windows-specific examples.

​
Podman Configuration

To run Oracle MCP Servers in containers using podman: 
{
  "mcpServers": {
    "oracle-oci-api-mcp-server": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "podman",
      "args": [
        "run", "-i", "--rm", 
        "-v", "/path/to/your/.oci:/app/.oci", 
        "oracle.oci-api-mcp-server:latest"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      }
    }
  }
}
Important Notes:
  • Replace "/path/to/your/.oci" with the actual path to your OCI configuration directory
  • Ensure the key_file field in /path/to/your/.oci/config uses the ~ character: 
    key_file=~/.oci/oci_api_key.pem
  • For servers not requiring OCI credentials, omit the -v volume mount

​
HTTP Streaming Configuration

If you’re running an MCP server as a standalone HTTP service:
  1. Start the server:
ORACLE_MCP_HOST=127.0.0.1 ORACLE_MCP_PORT=8888 uvx oracle.oci-api-mcp-server
  1. Configure Cline:
{
  "mcpServers": {
    "oracle-oci-api-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8888/mcp"
    }
  }
}
Cline uses streamableHttp as the transport type for HTTP streaming, not http.

​
Configuration Options

​
autoApprove

List of tool names that Cline can execute without asking for approval: 
"autoApprove": ["get_instance", "list_compartments"]

​
disabled

Disable a server without removing its configuration: 
"disabled": true

​
timeout

Maximum time in seconds to wait for server responses: 
"timeout": 60

​
Verification

1

Check Server Status

After saving cline_mcp_settings.json, return to the Cline panel and check the Installed tab.
2

Verify Green Toggle

Your MCP servers should appear with a green toggle indicating they are enabled and connected.
3

Test Connection

Click Done when finished. Try asking Cline to use one of the Oracle MCP Server tools to verify the connection works.

​
Troubleshooting

​
Server Not Appearing

  • Verify the JSON syntax is valid (no trailing commas, proper quotes)
  • Check that uv is installed and in your PATH
  • Ensure the OCI profile exists in ~/.oci/config

​
Connection Errors

  • Verify OCI authentication is properly configured
  • Check the FASTMCP_LOG_LEVEL for more detailed error messages
  • For podman configurations, ensure the container image is built

​
Permission Issues

  • Ensure the OCI configuration directory has proper read permissions
  • For podman, verify the volume mount path is correct

​
Multiple Servers

You can configure multiple Oracle MCP Servers simultaneously: 
{
  "mcpServers": {
    "oracle-oci-api-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": ["oracle.oci-api-mcp-server@latest"],
      "env": {
        "OCI_CONFIG_PROFILE": "DEFAULT",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    },
    "oracle-dbtools-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": ["oracle.dbtools-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

​
Next Steps

Explore Available Servers

Discover all Oracle MCP Servers you can connect to

Authentication Guide

Learn more about OCI authentication

Build docs developers (and LLMs) love

Get started for freeTalk to us