AI & Integrations

Give your AI agents and tools secure, scoped access to your real machines — list devices, run commands, browse and move files — over a clean REST API and a hosted MCP server.

How it works

Everything is authenticated with an API key you create on your profile. Each key is limited to the scopes (what it can do) and the devices (which machines it can touch) you choose, is rate‑limited, and every command it runs is recorded in an audit log. There are two ways to use it:

  • MCP (for AI agents) — point Claude / OpenClaw at https://folderbird.com/mcp with your key. The agent gets tools like run_command and browse_folder automatically.
  • REST (for everything else) — call https://folderbird.com/api/v1 from n8n, a webhook, or a script.

Quick start

1 · Create a key

Click your name (top‑right) → Manage API keysCreate a key. Pick its scopes (e.g. devices:read exec), choose which devices it can reach, and copy the fbk_live_… value — it's shown only once.

2 · Make your first call

curl https://folderbird.com/api/v1/devices \ -H "Authorization: Bearer fbk_live_YOUR_KEY"

3 · Or connect an AI agent

Add a remote MCP server in your agent with the URL https://folderbird.com/mcp and your key as a bearer header — see AI Agents & MCP.

Security first. Keys are stored hashed (shown once), scoped, device‑bound, rate‑limited, and every exec is audited. Treat a key like a password — anyone holding it can act on the devices it's bound to.