Look MCP

Support

Questions or problems? Most answers are below. If not, write to support@coolplay.io.

Getting started

  1. Open Look MCP. It lives in the menu bar (the small window with a sparkle) and has no Dock icon.
  2. Under Connect Your AI, click Copy Setup Prompt and paste it into your AI agent. The agent adds Look MCP to its own settings.
  3. Click Try It to see how showing a window and pointing work, or ask your AI for help with something on your screen.

Common questions

Which AI apps work with Look MCP?

Any app that supports MCP servers (Model Context Protocol) and can read pictures. Agents that can edit their own settings, such as coding agents, set themselves up from the setup prompt. For other apps, open Manual Setup, pick your app and click Copy Settings.

Download or App Store?

Both are the same app, and both update themselves. The Mac App Store keeps its version up to date. The version you download here is signed and checked by Apple (notarized) too, and looks for a new version once a day: it shows you what's new, and after your click it downloads the update, installs it and starts again. Check for Updates… in the menu looks right away. Use one or the other, not both.

Can my AI see my screen without me?

No. Every look opens a window that names the AI app and says why it's asking. You then pick the window in macOS's own window picker, or click Not Now. Your AI gets a picture of that one window and nothing else.

Can it click or type?

No. It can only show a ring on your screen where it means, with a short label. You do the clicking and typing.

What does “Share While You Work” do?

Your AI can then look at the same window again without asking, for example after each step it guides you through. The sharing goes on as long as you're at it: it ends 5 minutes after your last step or message. You choose it with every request; Share Once gives it a single picture. The panel shows what's shared, and Stop Sharing ends it at once. In the last minute, the status box shows the time left and a Keep Sharing button. macOS also shows its own sharing indicator in the menu bar while it lasts.

Can my AI see dialogs and popups?

Yes, when it asks to see the whole app. Apps like After Effects or Photoshop open dialogs, popups and panels in windows of their own, which a single shared window doesn't include. Your AI can then ask for the app instead: you pick it in the same system picker, and it sees that app's windows only, nothing else on your screen.

How does it guide me through several steps?

Your AI can mark several things at once with numbered rings. If something has to be typed, the ring's label shows the text with a Copy button. A ring stays until you've clicked there; the tick on its label marks the step done by hand. While the window stays shared, a ring keeps to its spot when you scroll, and an arrow at the window's edge shows which way to scroll when the spot is out of sight. A small status box at the bottom of the screen shows how many steps are done and when your AI is looking at the result. Its Done button ticks off all steps, and Stop Sharing ends everything.

Can I ask my AI something while it guides me?

Yes. While your AI waits for your steps, the status box shows a speech bubble button. Click it, write a sentence and press Return: your AI gets it at once, together with a fresh picture if the window stays shared, and answers right there. The conversation stays open, with what you and your AI said, until you close it with Esc or the button. Your AI can also ask you something there.

Does it need Screen Recording permission?

No. Look MCP uses the window picker built into macOS. Picking a window there is the permission, and it covers that window only.

Does Look MCP start by itself?

Only when your AI needs it. If Look MCP is closed and your AI asks to see a window, it starts and its icon appears in the menu bar. Opening your AI app, or a new chat in it, leaves Look MCP closed.

Troubleshooting

My AI says it can't see pictures

Your AI app has to be able to read pictures that a tool returns. Most current agents can. If yours can't, it still gets the app's name and the window's title, but not what's in the window.

A hint covers what I need to read

Move the pointer over the label: it turns see-through, and its buttons stay. Hold ⌥ (Option) for a moment and all hints disappear until you let go. Your AI can also put a label on another side of its ring; just tell it the label is in the way.

The ring is in the wrong place

Press the round arrow in the status box (Look Again): your AI gets a fresh picture and places its rings anew. A ring follows the window when you move it, and the page when you scroll, as long as the window stays shared; a spot that scrolls out of sight shows as an arrow at the window's edge. After a very fast scroll a ring can lose its spot, and your AI then looks again by itself once the page rests. With Share Once a ring can't follow scrolling: scroll back, or ask your AI to look again. Scrolling sideways isn't followed either.

My AI says the window isn't on screen any more

The window was closed, minimized or moved to another desktop. Bring it back and ask your AI to look again.

My AI says it can't reach Look MCP

I can't find the menu bar icon

Open Look MCP again from Spotlight or the Applications folder. It tells you where its icon is, or that it's hidden because the menu bar is full, and how to make room.

Contact

Email support@coolplay.io, or use the address in About Look MCP, which fills in your app version and macOS version. We usually reply within one to two business days.