← All integrations

Guide

Read your runs from an AI assistant

Connect OKShip to an AI assistant that supports MCP, then ask about your apps and runs in plain words: which runs failed, what a run found, where the replay is.

Before you start

  • An OKShip account on a team. Any role can connect, including viewers.
  • An AI assistant that can add a remote MCP server by its address and sign in to it.

Connect your assistant

  1. 1. Add OKShip as a connector

    In your assistant's connector or MCP settings, add a new server with this address:

    https://okship.dev/api/mcp

    An assistant's add-connector screen with the OKShip server address filled in
  2. 2. Sign in with your OKShip account

    Your assistant sends you to OKShip to sign in. Sign in, and approve access if you're asked. Your assistant never sees your password.

    The OKShip sign-in and approve-access screen the assistant opens
  3. 3. Ask it something

    Try: "List my OKShip apps."

    An assistant answering "List my OKShip apps" with real app names

What it can read

The connection is read-only. Your assistant can't start runs, change anything or share anything. It has four tools:

  • List apps: your team's apps, with their names and addresses.
  • List runs: runs for your team or for one app, newest first.
  • Get run: one run, with each goal's result and its steps.
  • Get run artifacts: links to the run's replay video and step screenshots. The links expire.

Every answer marks where each piece came from: recorded by OKShip, judged by the model, or written by your team. A verdict is the model's judgment, not a measurement.

One team at a time

Each request your assistant makes reads one OKShip team, never several.

If you're on more than one team, it reads the team you signed in for. If no team was chosen at sign-in, it reads the team you last used in OKShip, or your first team if you're no longer on that one.

Security

See it on your own site

Point OKShip at your site, write what a user should be able to do, and get a report and a link you can send.

Try it for free