Getting started
Prerequisites:
- Node.js version 18 or higher
- Claude Desktop, with an account that can add integrations and MCP servers (other clients coming soon)
- MacOS (for now) - This guide and the current release are for Mac users. We’re working on support for other platforms.
Fork the Codespace repo
Fork this repo.Generate a GitHub PAT for the Codespace repo
Navigate to GitHub (here) to generate a fine-grained GitHub PAT that only has access to the codespace-executor repo you forked and has the following codespaces permissions below (screenshots to follow):- Codespaces: Read and write
- Codespaces lifecycle admin: Read and write
- Codespaces metadata: Read-only
- Metadata: Read-only (this is preselected and mandatory on all fine-grained GitHub PATs)
If you are unfamiliar with GitHuB Personal Access Tokens (PAT) then refer to GitHub’s docs here for more info.
Set up in Claude Desktop
Download the keyboard-mcp.dxt file found here: dxt github release. Navigate to the Claude Desktop app Extensions page via the Claude settings page or alternatively open the.dxt file and you will be taken direclty to the setup.
Install Keyboard desktop app
You can download and run the Keyboard desktop app here. Just unzip it and run.
Create an account and get started.
Create an account and get started.
Connect the Keyboard approver app to Claude
After you log in to the desktop app, find the “Settings” button. Once there, find your WebSocket key and copy it.
Try your first prompt
Navigate back to the Claude chat in your Claude Desktop and try a prompt like this:
Troubleshooting
Claude is not performing the requested task
Claude is not performing the requested task
If Claude is trying to give you instructions or isn’t performing the requested task you can try the following steps:
- Ensure you have Keyboard open
- Ask Claude to connect to Keyboard
- Specifically call out Keyboard in your prompt (i.e. Use Keyboard to…)
- Ensure you have given Keyboard access to the app via these steps
- Ask Claude what environment variables it is connected to and ensure that it has access to the API of the tool you are trying to use
Not seeing notifications from Keyboard
Not seeing notifications from Keyboard
Go to the notifications settings on your Mac and ensure that notifications are turned on for Keyboard. This can be found by going to System Settings > Notifications > Scrolling to find Keyboard Approver App.Even if you don’t have notifications turned on you will still see an orange dot on the keyboard icon inn the menu bar on the top of your screen.
Claude is not loading
Claude is not loading
Try quitting out of Claude and reopening it.
Keyboard Approver App is not redirecting properly
Keyboard Approver App is not redirecting properly
Run the following command on your Mac: