---
title: "Quickstart | OwlMeans"
description: "Connect a coding agent, check the session and begin with a small request."
url: "https://owlmeans.com/docs/mcp/quickstart/"
lang: "en"
---

# Quickstart

![](https://owlmeans.com/_astro/mcp-quickstart.BiFKR3DN_Z2vIPlb.webp)

Connect a coding agent, check the session and begin with a small request.

## Local server

1.  Install Node.js **22 or newer** and confirm `npx` is available to the client.
2.  Open the project directory in your coding client.
3.  Register a stdio server named **owlmeans** with this command:

```
npx -y @owlmeans/viable-mcp@^0.2.0
```

4.  On first use, sign in to OwlMeans in the browser and approve access.

5.  Ask the agent to call `describe_platform` and `session_status`.

6.  Review the [project location and inference mode](https://owlmeans.com/docs/mcp/choose-project-location-and-inference-mode) the session reports.

    ![OwlMeans MCP settings: 1, inference preference; 2, client setup tabs.](https://owlmeans.com/_astro/mcp-settings.C46Z_RMB_zICmB.webp)

    OwlMeans MCP settings: 1, inference preference; 2, client setup tabs.

7.  Ask it to create an app or attach an existing project.

The default project target is **local**. To use a hosted project instead, add `--target cloud` to the server arguments.

## Hosted connection

Use a client that supports remote MCP and browser authorization. Add this server URL:

```
https://api.owlmeans.com/mcp
```

The hosted endpoint manages cloud projects. It cannot run a command in your local workspace or provide local delegated execution.

## First request

“Use OwlMeans to create a small project and task management app. First draft the specification and show it to me. Do not accept it until I have reviewed it.”

Creation drafts the product first. `confirm_project` starts initialization after that review. Follow [generation and stories](https://owlmeans.com/docs/mcp/workflows/generate-an-app-and-develop-its-user-stories).

Use [your client’s guide](https://owlmeans.com/docs/mcp/clients/codex-cli) for a copyable configuration and [troubleshooting](https://owlmeans.com/docs/mcp/troubleshoot-your-mcp-connection) if the server does not appear.

## Names and marks

OpenAI, ChatGPT and related OpenAI marks belong to OpenAI; Codex is an OpenAI product. [Usage policy](https://openai.com/brand/).

Claude and Claude Code are Anthropic products; their names and marks remain with their respective owner. [Usage policy](https://www.anthropic.com/legal/commercial-terms).

Node.js, npx names and any associated marks remain with their respective owners or project maintainers. References identify products, standards or source examples. OwlMeans documentation does not imply sponsorship or endorsement by those owners.
