Skip to main content

Setup Guide

Get Aigents Work running with Claude Desktop in under 5 minutes.

Prerequisites​

Step 1: Create an API Key​

An API key connects Claude Desktop to your Aigents Work account. This allows you to:

  • Create expressions that are linked to your account
  • View and manage your expressions in the portal
  • Keep your creations private or share them with others

To create an API key:

  1. Sign in to the Aigents Work Portal
  2. Go to Settings > API Keys
  3. Click Create API Key
  4. Give it a name (e.g., "Claude Desktop") and select the permissions you need
  5. Copy the key immediately - you won't be able to see it again!

Step 2: Configure Claude Desktop​

Open Claude Desktop's configuration file:

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

Add the Aigents Work MCP server to your config with your API key:

{
  "mcpServers": {
    "aigentswork": {
      "command": "npx",
      "args": ["@aigentswork/mcp-server"],
      "env": {
        "AIGENTSWORK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace your-api-key-here with the API key you copied in Step 1.

The MCP server will be automatically downloaded and run when Claude Desktop starts.

Step 3: Restart Claude Desktop​

Close and reopen Claude Desktop to load the new MCP server.

Step 4: Start Creating!​

Now you can ask Claude to create interfaces for you. Try these prompts:

"Create a simple dashboard showing website analytics"

"Build a contact form with name, email, and message fields"

"Make a todo list app with add, complete, and delete functionality"

Claude will create an expression and push it to your Aigents Work portal. You'll get a link to view your new interface.

View Your Creations​

Visit the Aigents Work Portal to see all your expressions. Each expression has:

  • View Details - See the JSON definition and version history
  • Render - View the live, interactive interface

Troubleshooting​

MCP server not connecting​

  1. Check that the config file is valid JSON
  2. Restart Claude Desktop
  3. Look for error messages in Claude's developer console

Expression not appearing in portal​

  1. Make sure your API key is configured correctly
  2. Check that the API key has the necessary permissions (read, write)
  3. Check your internet connection
  4. Try refreshing the portal page

API key not working​

  1. Make sure you copied the entire API key
  2. Check that there are no extra spaces or quotes around the key
  3. Create a new API key if the current one may have been compromised

Need help?​

Open an issue on GitHub and we'll help you out.