Skip to content

Installation

Get started with Actify in 3 simple steps: sign up, get your token, and configure your AI client.

Overview

Actify is a fully managed SaaS platform. You don't need to install or run any servers - just configure your AI client to connect to Actify's MCP server.

What you need:

  • An Actify account (free to start)
  • An MCP-compatible AI client (Claude Desktop, VS Code, Cursor, or ChatGPT)

Step 1: Get Your API Token

  1. Sign up at actify.dev
  2. Go to your DashboardAPI Tokens
  3. Click Generate New Token
  4. Copy your Personal Access Token (PAT)

⚠️ Important: Save your token securely - it won't be shown again.

Step 2: Configure Your AI Client

Choose your preferred AI client below:

Claude Desktop App

Step 1: Locate your Claude Desktop configuration file:

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

Step 2: Add the Actify MCP server configuration:

json
{
  "mcpServers": {
    "actify": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-actify"],
      "env": {
        "ACTIFY_API_URL": "https://api.actify.dev",
        "ACTIFY_PAT": "your_personal_access_token_here"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Step 4: Verify installation by asking Claude:

What MCP tools do you have access to?

You should see Actify tools like code_execute, code_schedule, etc.


VS Code with Claude Code

Step 1: Install the Claude Code extension from the VS Code marketplace

Step 2: Open VS Code Settings (JSON) by pressing Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for "Preferences: Open User Settings (JSON)"

Step 3: Add MCP server configuration:

json
{
  "claude-code.mcpServers": {
    "actify": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-actify"],
      "env": {
        "ACTIFY_API_URL": "https://api.actify.dev",
        "ACTIFY_PAT": "your_personal_access_token_here"
      }
    }
  }
}

Step 4: Reload VS Code window

Step 5: Test by asking Claude Code:

Execute this code: console.log('Hello from Actify!')

Cursor IDE

Step 1: Open Cursor Settings

Step 2: Navigate to Features → Model Context Protocol

Step 3: Click Add MCP Server and enter:

  • Name: actify
  • Command: npx
  • Args: ["-y", "@modelcontextprotocol/server-actify"]
  • Environment Variables:
    • ACTIFY_API_URL: https://api.actify.dev
    • ACTIFY_PAT: your_personal_access_token_here

Step 4: Save and restart Cursor

Step 5: Verify by asking the AI:

Show me my Actify credits balance

ChatGPT / OpenAI (Coming Soon)

OpenAI is adding MCP support to ChatGPT. Once available, you'll be able to:

  1. Go to ChatGPT Settings → MCP Servers
  2. Add Actify with your API token
  3. Start executing code through ChatGPT

Join the waitlist: actify.dev/openai-waitlist


Step 3: Verify Installation

Test Code Execution

Ask your AI assistant:

Execute this JavaScript code and return the result:
const message = 'Actify is working!';
const timestamp = new Date().toISOString();
return { message, timestamp };

Success! You should see the execution result with your message and timestamp.

Check Your Credits

How many Actify credits do I have?

You should see your current credit balance and usage statistics.

What You Can Do Now

With Actify connected, your AI has access to these powerful tools:

  • code_execute - Execute Node.js code on-demand
  • code_schedule - Schedule recurring jobs with cron
  • execution_status - Check status of running code
  • code_cancel - Stop running executions
  • get_credits - View your credit balance
  • manage_secrets - Store API keys and secrets securely
  • list_workflows - View execution history
  • system_status - Check Actify system health

Troubleshooting

"Authentication failed" Error

Cause: Your API token is incorrect or has been revoked.

Solution:

  1. Go to actify.dev/dashboard
  2. Navigate to API Tokens
  3. Generate a new token
  4. Update your MCP client configuration with the new token
  5. Restart your AI client

"MCP server not found" Error

Cause: The MCP client can't find the Actify connector.

Solution:

  1. Verify your configuration file syntax is valid JSON
  2. Ensure you've restarted your AI client after configuration
  3. Check that npx is available (run npx --version in terminal)

Tools Not Appearing in Client

Cause: MCP server not properly connected.

Solution:

  1. Completely quit and restart your AI client (not just reload)
  2. Check your client's MCP connection logs
  3. Verify the configuration file path is correct for your OS
  4. Test the connection by asking: "What MCP tools do you have?"

Rate Limit Errors

Cause: Too many requests in a short time.

Solution:

  1. Wait a few seconds between requests
  2. Upgrade your plan at actify.dev/pricing for higher limits

Need More Help?


Next Steps

Now that Actify is installed, learn what you can do: