Skip to main content

Claude Desktop Setup

Prerequisites​

  • Claude Desktop (download from claude.ai)
  • Unizo API key and File Storage integration ID
  • Node.js v20 or higher

Setup Instructions​

  1. Install @mcp-remote if not already installed:

    npm i mcp-remote

  2. Open Claude Desktop and navigate to Settings → Developer → Edit Config

  3. Add the Unizo File Storage configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "unizo": {
      "command": "/Users/{user_name}/.nvm/versions/node/v18.x.x/bin/node",
      "args": [
        "/Users/{user_name}/.nvm/versions/node/v18.x.x/bin/mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes:storage"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Flags: If npx is producing errors, consider adding -y as the first argument to auto-accept the installation of the mcp-remote package.

{
  "mcpServers": {
    "unizo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes:scm"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

  1. Save the file and restart Claude Desktop

  2. Verify the connection - The tools may take a minute to appear. You should see storage tools available in Claude.

Available Tools​

Once configured, you'll have access to:

  • storage_list_connectors - Get list of available storage services
  • storage_list_integrations - Get integrations for a specific storage service
  • storage_list_drives - Browse available drives with pagination
  • storage_get_drive_details - Retrieve comprehensive drive information
  • storage_list_folders - Browse and search folders with pagination
  • storage_get_folder_details - Retrieve detailed folder information
  • storage_create_folder - Create a new folder
  • storage_update_folder - Update folder properties
  • storage_delete_folder - Delete a folder
  • storage_list_files - Browse and search files with pagination
  • storage_get_file_details - Retrieve comprehensive file information
  • storage_create_file - Create a new file
  • storage_update_file - Update file content
  • storage_delete_file - Delete a file
  • storage_list_users - Browse storage users with pagination
  • storage_get_user_details - Retrieve user information
  • storage_list_groups - Browse storage groups with pagination
  • storage_get_group_details - Retrieve group information
  • storage_list_versions - List file version history
  • storage_get_version_details - Retrieve specific version information
  • storage_list_permissions - List file permissions
  • storage_get_permission_details - Retrieve permission details
  • storage_add_permission - Add file permission
  • storage_delete_permission - Remove file permission
  • storage_list_comments - List file comments
  • storage_get_comment_details - Retrieve comment information
  • storage_create_comment - Create a new comment
  • storage_update_comment - Update comment content
  • storage_delete_comment - Delete a comment

Multiple Integrations​

To work with multiple categories or integrations, add them as a comma-separated list under the x-mcp-scopes header:

{
  "mcpServers": {
    "unizo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes : storage,scm,ticketing"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Troubleshooting​

Tools not appearing​

  • Ensure Claude Desktop is fully restarted
  • Verify your API key is valid
  • Check the Developer Console in Claude Desktop for errors

Connection errors​

  • Verify Node.js v20+ is installed
  • Check that your integration is active in Unizo dashboard

Debug mode​

Add debug environment variables:

{
  "env": {
    "UNIZO_API_KEY": "your_api_key",
  }
}