# GRASP MCP Re-Auth Steering File for Kiro

*By David Pitera (@piteradp) — shared in #kiro-productivity-for-all*

## What This Does

When GRASP MCP shows a red/disconnected status in Kiro, this steering file tells Kiro exactly how to re-authenticate it — no manual steps required. Just tell Kiro "re-auth GRASP using the steering file."

## The Steering File

Save this as `~/.kiro/steering/grasp-reauth.md`:

---

```markdown
# GRASP Re-Authentication Procedure

When GRASP MCP shows as disconnected or authentication fails, follow this procedure:

## Quick Re-Auth (try first)
1. Run: `aim auth refresh grasp`
2. Check status: `aim status grasp`
3. If still failing, proceed to full re-auth below.

## Full Re-Auth Procedure
1. Clear existing GRASP credentials:
   ```
   wsl.exe -d AmazonWSL -- bash -c "rm -f ~/.aim/credentials/grasp* 2>&1"
   ```
   
2. Re-initialize GRASP auth:
   ```
   wsl.exe -d AmazonWSL -- bash -c "aim auth login grasp 2>&1"
   ```
   This opens a browser window — complete the Midway login.

3. Verify connection:
   ```
   wsl.exe -d AmazonWSL -- bash -c "aim mcp grasp --verify 2>&1"
   ```

4. Restart Kiro's MCP connection (File → Reload MCP Servers, or restart Kiro).

## If Browser Auth Fails
Run mwinit first, then retry:
```
wsl.exe -d AmazonWSL -- bash -c "mwinit -o && aim auth login grasp 2>&1"
```

## Signs GRASP is Working
- Status indicator is green in Kiro MCP panel
- `aim status grasp` returns "authenticated"
- You can run: `aim mcp grasp search "test query"` without errors
```

---

## How to Use

1. Save the steering file above to `~/.kiro/steering/grasp-reauth.md`
2. When GRASP goes red, open Kiro and type:
   > "GRASP is showing red — re-auth me using the grasp-reauth steering file"
3. Kiro reads the file and executes the steps automatically.

## Pro Tip

David's workflow: pop this text file into Kiro and tell it to **make a steering file for you too** — Kiro will format it properly for your setup.

---
*Original .rtf file shared by David Pitera (@piteradp) in #kiro-productivity-for-all — May 18, 2026*