# Kiro

[<mark style="color:blue;">Kiro</mark>](https://kiro.dev) is a GA AI IDE from AWS built for spec-driven development. It supports MCP natively with standard `mcpServers` JSON configuration.

## Prerequisites

* Kiro installed. For more information, see [<mark style="color:blue;">kiro.dev</mark>](https://kiro.dev)
* The `ionoscloud-mcp` binary built and available. For more information, see [<mark style="color:blue;">Quick Start</mark>](/cloud/ai/mcp-server/quick-start.md)
* An <code class="expression">space.vars.ionos\_cloud\_api</code> token. For least-privilege access, see [<mark style="color:blue;">Authentication</mark>](/cloud/ai/mcp-server/configuration/authentication.md#token-scope-by-product-area) to scope the token to only the tools you need.

## Add the MCP server

Create or edit `.kiro/settings/mcp.json` in your workspace:

```json
{
  "mcpServers": {
    "ionoscloud": {
      "command": "/usr/local/bin/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token"
      }
    }
  }
}
```

To also enable Object Storage tools:

```json
{
  "mcpServers": {
    "ionoscloud": {
      "command": "/usr/local/bin/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token",
        "IONOS_S3_ACCESS_KEY": "your-access-key",
        "IONOS_S3_SECRET_KEY": "your-secret-key"
      }
    }
  }
}
```

For a user-wide configuration that applies to all projects, use `~/.kiro/settings/mcp.json` instead. Workspace config takes precedence when both exist.

Kiro supports environment variable interpolation using `${VARIABLE_NAME}` syntax. This is the recommended approach for team configs where each developer supplies their own credentials:

```json
"env": {
  "IONOS_TOKEN": "${IONOS_TOKEN}"
}
```

Kiro also supports per-tool settings within the server entry:

```json
"ionoscloud": {
  "command": "/usr/local/bin/ionoscloud-mcp",
  "env": { "IONOS_TOKEN": "your-api-token" },
  "autoApprove": ["list_datacenters", "list_servers"],
  "disabledTools": []
}
```

`autoApprove` lists tools Kiro runs without asking for confirmation. `disabledTools` hides specific tools from the AI's catalog.

{% hint style="info" %}
**Kiro-specific feature:** `autoApprove` and `disabledTools` are Kiro IDE settings; they are not features of the MCP server itself. Other AI clients (Claude Desktop, Cursor, VS Code, etc.) do not support per-tool approval or disabling at the config level. The MCP server exposes all registered tools to whichever client connects.
{% endhint %}

## Verify the connection

{% stepper %}
{% step %}

### Open Kiro and start a chat

Open the Kiro Agent panel.
{% endstep %}

{% step %}

### Test the connection

Type: *List my* <code class="expression">space.vars.ionos\_cloud</code> *data centers.*

{% hint style="success" %}
**Result:** Kiro calls `list_datacenters` and returns your data centers.
{% endhint %}
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Note:** All tools are registered at startup by default, so Compute Engine and Object Storage tools appear immediately. To reduce the startup tool count (for example, on clients with a tool-count cap), set `IONOS_MCP_LOAD_MODE=lazy` in the `env` block and call the `ionos_load_compute_tools` or `ionos_load_objectstorage_tools` sentinels on demand. For more information, see [<mark style="color:blue;">Selective Tool Loading</mark>](/cloud/ai/mcp-server/configuration/selective-tool-loading.md).
{% endhint %}

For full Kiro MCP documentation including security settings, see [<mark style="color:blue;">kiro.dev/docs/mcp</mark>](https://kiro.dev/docs/mcp/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/ai/mcp-server/connect-to-an-ai-client/kiro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.