Quickstart for Claude Desktop

Claude Desktop connects to your Files.com site through the Files.com MCP Server. You have two options. The Remote MCP Server requires no software installation and is the recommended path for most users. The Local MCP Server installs and runs on your own machine. Follow the section that matches your setup.

You will need a Files.com API Key regardless of which method you choose.

Install Claude Desktop

Download the Claude Desktop app and install it.

Claude Desktop is available for Windows and Mac.

Connecting via the Remote MCP Server

The Remote MCP Server runs on your Files.com site. Your API Key authenticates the connection. You can connect to multiple Files.com sites simultaneously by adding an entry for each site in your configuration.

To find your Remote MCP Server URL, substitute your Files.com subdomain or custom domain into the appropriate format:

https://<mysite>.files.com/api/ai/mcp/v1/

https://<mycustomdomain>/api/ai/mcp/v1/

Install Node.js

Claude Desktop uses npx to connect to the Remote MCP Server. npx is included with Node.js. Download and install Node.js for your operating system.

Make sure that npx is working correctly prior to proceeding. Use the following command from a terminal window to verify that npx is working:

• npx --version

Configure Claude Desktop for the Remote MCP Server

Update the configuration file for Claude Desktop to point at the Files.com MCP Server.

The configuration file can be found at:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following to your configuration file, replacing YOUR_API_KEY with your Files.com API Key and the URL with your site's Remote MCP Server URL:

{
  "mcpServers": {
    "My Files.com Site": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mysite.files.com/api/ai/mcp/v1/",
        "--transport",
        "http-only",
        "--header",
        "X-FilesAPI-Key: YOUR_API_KEY",
        "--no-auth"
      ]
    }
  }
}

Make sure that the JSON contained in the configuration file is valid and has no syntax errors. Claude Desktop will not register an MCP server if its configuration file is corrupt or invalid.

Save the file and restart Claude Desktop. Files.com will appear as an available connector in Claude Desktop.

Connecting via the Local MCP Server

The Local MCP Server is a Python package you install and run on your machine. Setup takes a few minutes and requires installing Python and the uv package manager before configuring Claude Desktop.

Install Python

Download and install the Python programming language for your operating system.

Install uv

Install the uv Python package and project manager. This manager is recommended for running Python based MCP servers with Claude.

Follow the official installation instructions for your operating system.

Make sure that uv is working correctly prior to proceeding. Use the following command from a terminal window to verify that uv is working:

• uv --version

Install Files.com MCP Server

Prepare a virtual environment for the installation:

uv venv

Install our MCP Server using uvx to manage the package installation:

uvx pip install files-com-mcp

Configure Claude Desktop for the Local MCP Server

Update the configuration file for Claude Desktop to point at the local MCP Server.

The configuration file can be found at:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following, replacing YOUR_API_KEY with your Files.com API Key:

{
  "mcpServers": {
    "Files.com": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "files-com-mcp"
      ],
      "env": {
        "FILES_COM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Make sure that the JSON contained in the configuration file is valid and has no syntax errors. Claude Desktop will not register an MCP server if its configuration file is corrupt or invalid.

Save the file and restart Claude Desktop. Files.com will appear as an available connector in Claude Desktop.

Debugging

Claude Desktop provides debugging information to help you troubleshoot issues and verify connectivity with its AI and any connected MCP tools.