Appearance
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
- Sign up at actify.dev
- Go to your Dashboard → API Tokens
- Click Generate New Token
- 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.devACTIFY_PAT:your_personal_access_token_here
Step 4: Save and restart Cursor
Step 5: Verify by asking the AI:
Show me my Actify credits balanceChatGPT / OpenAI (Coming Soon)
OpenAI is adding MCP support to ChatGPT. Once available, you'll be able to:
- Go to ChatGPT Settings → MCP Servers
- Add Actify with your API token
- 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:
- Go to actify.dev/dashboard
- Navigate to API Tokens
- Generate a new token
- Update your MCP client configuration with the new token
- Restart your AI client
"MCP server not found" Error
Cause: The MCP client can't find the Actify connector.
Solution:
- Verify your configuration file syntax is valid JSON
- Ensure you've restarted your AI client after configuration
- Check that
npxis available (runnpx --versionin terminal)
Tools Not Appearing in Client
Cause: MCP server not properly connected.
Solution:
- Completely quit and restart your AI client (not just reload)
- Check your client's MCP connection logs
- Verify the configuration file path is correct for your OS
- Test the connection by asking: "What MCP tools do you have?"
Rate Limit Errors
Cause: Too many requests in a short time.
Solution:
- Wait a few seconds between requests
- Upgrade your plan at actify.dev/pricing for higher limits
Need More Help?
- 📧 Email: support@actify.dev
- 💬 Discord: discord.gg/actify
- 📚 Documentation: docs.actify.dev
Next Steps
Now that Actify is installed, learn what you can do:
- 🚀 Example Workflows - 40+ real-world automation examples
- 📖 Quick Start Guide - Step-by-step tutorial
- 🔧 MCP Tools Reference - Explore all available tools
- 💡 Code Examples - Learn from practical examples
- 📊 Dashboard - Monitor your usage and executions