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 Dashboard → API 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: