360 Secure SkillHub
360 安全技能中心

port-getting-started

面向首次使用 Port 的引导 Skill：说明注册 Port 账号、按区域选择 MCP 服务器地址，并在 Cursor、Claude Code、VS Code 等客户端完成 MCP 连接，另可选安装 Port CLI；同时提供连接失败的排查表与快速参考，并建议连接后优先调用 Port 自身工具而非猜测。

port-labs
热度 0.00
最近更新 2026-10-19 00:22:15
分类：开发依赖：MCP 服务 / 第三方 API / 代码执行应用场景：API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add port-labs/port-skills/port-getting-started
Metadata
name
port-getting-started
description
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.
license
MIT
compatibility
Claude Code, Cursor, Codex CLI, GitHub Copilot, VS Code
metadata
{"version":"1.0.0","author":"port-labs","repository":"https://github.com/port-labs/port-skills","tags":"port,setup,mcp,onboarding,reference","summary":"Sign up for Port and connect its MCP server to your coding agent"}

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

  1. Sign up for a Port account at app.port.io if you don't have one yet.

  2. 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

  3. 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.

  4. 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.

  5. 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