Port getting started

Skill port-labs/port-skills/skills/port-getting-started

Set up Port and connect it to your coding agent: sign up for a Port account, install Port's MCP server, and optionally the Port CLI. Use when asked to 'get started with Port', 'set up Port', 'connect Port MCP', 'install the Port MCP server', 'how do I use Port from Claude Code/Cursor/VS Code', or before using any other skill in this repo for the first time.From its SKILL.md

Install

npx -y skills add port-labs/port-skills --skill port-getting-started

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.5 KB, as published. Nobody here has run it

Getting started with Port

Every other skill in this repo produces correct Port config either way, but without Port's MCP server connected, you're copying that config in by hand. With it connected, the agent can read your live account and apply changes directly. Do this once, first.

Prerequisites

None. This is the first skill to run.

How to get started

Sign up for a Port account at app.port.io if you don't have one yet.
Find your Port region. Check your Port app's base URL: if it contains us, you're on the US region; otherwise you're on EU.

Region MCP server URL
EU https://mcp.port.io/v1
US https://mcp.us.port.io/v1

Connect Port's MCP server to your coding agent, using the URL for your region from the table above:

Client	How to connect
Cursor	Install EU or add an MCP server manually with your region's URL
Claude (claude.ai / Claude Desktop)	Install from the Claude directory, then enter your region's MCP server URL when prompted
VS Code	Add `port-eu` or `port-us` as an MCP server using the URL for your region
Claude Code (CLI)	`claude mcp add --transport http port-eu https://mcp.port.io/v1` (or `port-us` / `https://mcp.us.port.io/v1`)
Any other MCP-compatible agent	Point it at your region's URL, or follow the manual install docs

This repo's own .mcp.json already ships both port-eu and port-us servers, so installing this plugin gets you both — disable whichever region doesn't apply to your account.

Optional: install the Port CLI. Beyond MCP, it covers day-to-day resource management from the terminal, and port skills sync pulls any skills your org has already configured in Port straight into your coding agent's skill directory.
Once connected, prefer Port's own tools over guesswork. Every skill in this repo notes where it can call Port's MCP tools directly (to read live state or apply a change) instead of just handing you config to copy in. If a skill doesn't cover something you need, search Port's documentation from inside the agent with the search_port_knowledge_sources MCP tool rather than guessing.

Common pitfalls

Symptom	Cause	Fix
MCP server added but no Port tools show up	Most agents need a session restart after adding an MCP server	Restart the coding agent
The Cursor/VS Code install link does nothing when clicked	Some browsers block custom URI schemes by default	Use the manual install docs instead
`claude mcp add` command not found	That command is Claude Code's own CLI, not Claude Desktop or claude.ai	Use the Claude directory link for Desktop/claude.ai instead
Tools work for one teammate but not another	Each person connected to the wrong region's server for their account	Re-check the Port app base URL and connect to that region's server instead

Quick reference

Sign up: app.port.io
MCP server URL (EU): https://mcp.port.io/v1
MCP server URL (US): https://mcp.us.port.io/v1
Manual install docs: docs.port.io/agent-management/port-mcp-server/installation
Port CLI: github.com/port-experimental/port-cli
Search Port's docs from inside a connected agent: the search_port_knowledge_sources MCP tool

Region	MCP server URL
EU	`https://mcp.port.io/v1`
US	`https://mcp.us.port.io/v1`