Skip to main content
Kiro is Amazon’s AI-powered IDE — the successor to Amazon Q Developer (Q is now retired for new signups). It supports remote MCP servers through a user-level mcp.json config. Perfai Cloud is a remote server and authentication is a custom Bearer header.
Amazon Q Developer’s free-tier signup is closed to new users — Kiro is currently the only viable free path in to this class of tooling.

​
Install Kiro

  1. Download Kiro from kiro.dev.
  2. Sign in with Google or GitHub — this avoids a known Amazon Builder ID account-linking bug that can affect email/password sign-in.
  3. Open a project folder in Kiro.

​
Get an API key

Perfai Cloud authenticates Kiro with a Perfai API key. Create one and copy it — Perfai shows the full key only once. You’ll paste it into mcp.json as Bearer pfk_xxxxxxxxxxxx_....

​
Installation

  1. In Kiro, press Ctrl+Shift+P (Cmd+Shift+P on macOS) to open the command palette.
  2. Run Kiro: Open User MCP Config (JSON).
  3. Add (or merge) the following into the file that opens:
File: ~/.kiro/settings/mcp.json
  1. Save the file. Kiro picks up MCP config changes without a restart.

​
Verify the server is connected

  1. Open Kiro’s MCP panel (via the command palette or the MCP icon in the sidebar).
  2. Look for perfai-cloud listed with 19 tools available.
  3. If it fails to connect, re-check that the Authorization header is Bearer followed by the full key, with no trailing whitespace. A 401 means the key has expired or been revoked — create a new one and update the config.

​
Confirm you’re signed in

The API key signs you in — there is no separate login step. Every tool call runs as the user who created the key, with that user’s organizations and role. In Kiro’s chat panel, type:
It answers with the key’s id (pfk_xxxxxxxxxxxx_…), never the secret. If a tool call fails with 401, the key has expired or been revoked — create a new one and update the connector.

​
Register an app and run a scan

​
Fix and verify