Getting Started
IDE Setup

Installation

How to set up Hydra with your development environment.

Web Dashboard

The easiest way to use Hydra is through the web dashboard:

  1. Visit hydra.opiusai.com (opens in a new tab)
  2. Sign up or log in with your account
  3. Create and deploy workflows directly in the browser

No installation required!

IDE Setup

To use Hydra workflows in your IDE, you need to configure the MCP connection.

Claude Code

Add the Hydra MCP server to your Claude Code settings file:

macOS/Linux: ~/.claude/settings.json Windows: %USERPROFILE%\.claude\settings.json

{
  "mcpServers": {
    "hydra": {
      "url": "YOUR_MCP_ENDPOINT_URL"
    }
  }
}

Replace YOUR_MCP_ENDPOINT_URL with the MCP endpoint from your deployment (Dashboard → Deployments).

Cursor

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Navigate to Extensions → MCP Servers
  3. Click Add Server
  4. Enter your MCP endpoint URL from Dashboard → Deployments

Codex / OpenAI API

For Codex integration, use the OpenAI API with function calling:

import openai
 
# Configure with Hydra functions
response = openai.ChatCompletion.create(
    model="gpt-4",
    messages=[...],
    functions=hydra_functions,  # Fetched from Hydra API
    function_call="auto"
)

See the Codex Integration Guide for details.

API Keys

To authenticate with Hydra:

  1. Go to Dashboard → Settings → API Keys (opens in a new tab)
  2. Click Generate New Key
  3. Copy the key (it won't be shown again)
  4. Use it in your IDE configuration
⚠️

Keep your API keys secure! Never commit them to version control.

Verifying Installation

To verify your setup is working:

  1. Open your IDE
  2. Try invoking a Hydra workflow: 
    List available Hydra workflows
  3. You should see your deployed workflows

Troubleshooting

Connection Failed

  • Check that your deployment ID is correct
  • Verify your API key is valid
  • Ensure you have an active deployment

Workflow Not Found

  • Make sure the workflow is deployed (not just created)
  • Check that you've enabled the correct adapter for your IDE

Authentication Error

  • Regenerate your API key in the dashboard
  • Update your IDE configuration with the new key

Next Steps

Core ConceptsDashboard Guide