Resources · Claude connector

Claude Port IO connectorWhat Claude can do in your Port portal.

The Claude Port IO connector exposes 12 tools: 7 read your catalog, 5 change it, 0 are undocumented. Here: what Claude can look up in Port, what it can run or edit, what it asks first, what your Port role decides, and who can switch it off.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What changes when Claude can query your Port catalog

Finding who owns a service, which scorecard it fails or which action deploys it usually means clicking through Port's catalog pages. With this connector you ask Claude in plain words: it queries blueprints, entities and scorecards itself, and, if your Port role allows it, runs a self-service action or edits the catalog model. Port decides which of those tools you even see, based on your permissions there.

Ownership answered in one question. You need the owner of a service: list_entities queries the services blueprint with filters, sorting and grouping, without anyone opening the catalog.

Standards checked before a release. You want to know what a scorecard checks: list_scorecards returns its complete rule configuration.

A governed action, launched from the chat. You need a self-service action: list_actions shows the self-service actions available with their inputs, then run_action runs the one that fits.

Now what the directory sheet does not say. Port splits its tools by role: upsert_blueprint, upsert_scorecard and upsert_action belong to the Builder set meant for platform engineers and admins, not to the Developer set. Port documents ways to hide all write tools or restrict which actions can run, but describes them for token-based setups, not for this directory connector. And nothing runs on its own: no tool wakes up when a scorecard drops. For background reactions you need an automation tool, a different job; the Integrations hub gathers that side.

Vocabulary

The vocabulary in one minute

Five words you will meet while connecting Port.

Connector
The link you set up once between Claude and an account you already own, so Claude can work in it while it answers you.
Tool
One named thing a connector lets Claude do in that account. Claude picks the ones it needs; the directory sheet lists them by name.
Authorization
Port's own sign-in screen, where you hand Claude the access it will use. Granted once per person, and it can be taken back.
Approval
The confirmation Claude waits for before it goes ahead with something that changes your portal, shown in the chat when it matters.
MCP
The shared standard connectors are built on: it is what lets an assistant such as Claude talk to a service outside it.
Connect

Setting up the Claude Port IO connector in three steps

  1. 01

    Find Port IO in Claude

    Open Claude's settings, go to Customize, then Connectors, and look for Port IO in the list. On a Team or Enterprise workspace, an Owner or Primary Owner enables the connector before each member can sign in on their own.

  2. 02

    Connect from its row

    Click Connect on the Port IO row, then sign in to Port in the window the service opens itself. If the link breaks later, Disconnect and connect again.

  3. 03

    Read the authorization screen

    Read the authorization screen before you accept. It belongs to Port, not to Claude, and it is what decides how far the access reaches. Port adds that the tools you then see depend on your permissions in Port.

Tools

The 12 tools, split by what they do

Port IO gives Claude 12 tools: 7 that read your account, 5 that change something in it.

Two groups: what Claude reads in your portal, and what it runs or changes there. Names stay exactly as Claude displays them.

  • 7 read
  • 5 write

What Claude reads (7)

7 tools

Seven tools that query the catalog, the docs or Port's guidance and leave everything as it is.

list_blueprints

Lists the blueprints of your organization as a summary or, for the ones you name, with property definitions, schemas and allowed values.

When it helps
you want to know which properties and allowed values a blueprint defines before querying its entities.

Sourcedocs.port.io · October 1, 2026 ↗

list_entities

Queries the entities of a blueprint with filters, sorting and pagination, and can also group values or return only a total count.

When it helps
you need a count of the entities matching a filter, or how a property's values are distributed.

Sourcedocs.port.io · October 1, 2026 ↗

list_scorecards

Lists your scorecards in summary, or with their complete rule configuration for the ones you ask about. The directory sheet lists scorecard analysis, next to service health, among the connector's uses.

When it helps
you want the exact rules of one scorecard laid out in one place.

Sourcedocs.port.io · October 1, 2026 ↗

list_actions

Lists the actions and automations of your organization, with their full input schemas when you name specific ones. It is the reading side of run_action, which then runs one of them by its identifier.

When it helps
you want to know which self-service actions exist and which inputs each one needs.

Sourcedocs.port.io · October 1, 2026 ↗

search_port_knowledge_sources

Searches the official Port documentation and returns the most relevant sections with their links and content, so Claude can answer questions about Port itself from its official documentation.

When it helps
you have a question about how a Port feature works.

Sourcedocs.port.io · October 1, 2026 ↗

load_skill

Loads Port's specialised guidance for a given task: step-by-step instructions for recurring work such as troubleshooting an integration. It loads guidance and leaves your portal as it is.

When it helps
an integration needs troubleshooting and you want Claude to follow Port's step-by-step guidance.

Sourcedocs.port.io · October 1, 2026 ↗

list_integrations

Lists the integrations installed in your organization, and for the ones you name, their complete configuration and mapping.

When it helps
you want to see how an installed integration is mapped.
Watch out
Port states that an empty result is authoritative: no integration is installed.

Sourcedocs.port.io · October 1, 2026 ↗

What Claude changes (5)

5 tools

Five tools that run actions or alter the catalog model. No source spells out their confirmation, so the general rule below applies.

run_action

Approval: see the rule

Runs a self-service action or automation by its identifier. The directory sheet describes these actions as governed, with built-in guardrails.

What Claude asks for
no source describes a confirmation specific to this tool, so the general approval rule below is what covers it.
When it helps
the action you need already exists in Port and you know its identifier.

Sourcedocs.port.io · October 1, 2026 ↗

upsert_blueprint

Approval: see the rule

Creates a blueprint, or updates it when it already exists.

What Claude asks for
nothing specific to this tool is documented; the default approval rule applies.
When it helps
a blueprint needs a new property.
Watch out
Port lists it among Builder tools, so a Developer profile may not have it.

Sourcedocs.port.io · October 1, 2026 ↗

upsert_entity

Approval: see the rule

Creates an entity, or updates an existing one, merging by default so the fields you do not touch are kept.

What Claude asks for
the sources say nothing about a prompt for this tool; rely on the approvals section.
When it helps
a team was renamed and its services must point to the new owner in the catalog.

Sourcedocs.port.io · October 1, 2026 ↗

upsert_scorecard

Approval: see the rule

Creates a scorecard, or updates it when it already exists. Port counts setting up scorecards among the jobs of its Builders, the platform engineers and admins who configure the portal.

What Claude asks for
no confirmation specific to scorecards is published; the general rule holds.
When it helps
a scorecard needs a new rule.

Sourcedocs.port.io · October 1, 2026 ↗

upsert_action

Approval: see the rule

Creates a self-service action or automation, or updates it when it already exists.

What Claude asks for
no source documents an approval for this tool; the section below holds the rule.
When it helps
an existing action needs one more input.
Watch out
Port's run_action can then run the updated version by its identifier.

Sourcedocs.port.io · October 1, 2026 ↗

Approvals

What Claude asks before it acts

By default, Claude stops and asks for your go-ahead before any action it takes on an account on your behalf. The request shows up in the conversation at the moment it matters.

No source says whether Claude asks before run_action or an upsert_* tool, so that default rule covers all five. On Team and Enterprise workspaces, owners decide whether members may let certain actions through without being asked, and they can restrict what a connector may do for the whole organization, keeping reading and blocking changes, for example. On the Port side, your role and permissions decide which tools you get at all. Claude never sees more than you do.

Plans

Which plans include it

None of the 819 sheets in the official directory shows availability by plan. The answer, connector by connector, is not published anywhere: a real gap in the catalogue.

The general rule is published: remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner enables a connector for the organization before members can sign in. For the current state, check the Port IO sheet in the official directory.

Limits

Where this connector stops

A connector is not an automation. Claude calls these tools while it answers you: nothing starts when an entity changes, a scorecard drops or an integration fails.

This connector has no Claude help article of its own; what we know comes from the directory sheet and from Port's tool reference. The tool list is an observed floor, not a promise: an administrator can open actions that no public sheet shows. The directory's verified badge is not a security audit, and Anthropic writes on every sheet that it does not control which tools a publisher exposes. Port is the only source documenting this connector's tools.

Need help

Need help connecting Port IO to Claude?

A person reads every message.

FAQ

Questions about the Claude Port IO connector

01What can Claude do with the Port IO connector?
Claude can query your Port software catalog and act on it from inside a conversation. Its seven reading tools cover blueprints, entities, scorecards, actions, installed integrations, a search through Port's documentation and Port's step-by-step guidance for specific tasks. Its five changing tools run a self-service action and create or update blueprints, entities, scorecards and actions. Which of them you actually see depends on your permissions in Port. Nothing starts on its own: Claude calls these tools only while it answers you.
02Can Claude change my Port catalog or run actions?
Yes, five of the twelve tools change things. run_action launches a self-service action or automation, and the four upsert_* tools create or update blueprints, entities, scorecards and actions. Port places upsert_blueprint, upsert_scorecard and upsert_action in its Builder set, meant for platform engineers and admins, not in the Developer set. upsert_entity, for its part, merges by default to preserve existing fields. No source describes a confirmation specific to those five tools.
03Does Claude ask me before it acts in Port?
By default, yes: Claude stops and asks for a confirmation before any action it takes on an account on your behalf. No source describes a confirmation specific to run_action or the upsert_* tools, so that default rule covers them. On a Team or Enterprise workspace, owners decide whether members may let some actions pass without a prompt, and they can also shut every changing tool for the whole organization. On the Port side, your role already filters which tools appear.
04Which Claude plans include the Port IO connector?
No official source publishes plan availability connector by connector, and none of the 819 directory sheets displays it. The general rule says remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, with an Owner or Primary Owner enabling them first on Team and Enterprise. The Port IO sheet in the official directory is the only place that shows the current state for your account, for Port IO as for any other remote connector.
05Does Claude see my whole Port portal?
It sees what your Port permissions let you see, and nothing beyond. Port states that the tools available depend on your role and permissions, so two colleagues may get different tool lists and different results from the same question. Inside that frame, Claude can query any blueprint you can read. On a Team or Enterprise workspace in Claude, an owner can additionally restrict what the connector may do for every member.
06Can I make the Port connector read-only?
Port documents a read-only mode that hides every write tool, plus a setting that limits which actions run_action may launch, but it describes both as headers for token-based connections. No source says they apply to the directory connector. Within Claude, owners of Team and Enterprise workspaces can restrict what a connector may do for the organization, keeping reading and blocking changes, and that setting binds every member. Port also notes that a custom connector created in Claude can expose only the tools you pick.
07Should I use Claude or an automation tool for Port?
They do different jobs, so it depends on the use. Claude with this connector suits a question or a request made in the moment: who owns this service, which rule fails, run this action now. An automation tool suits work that must happen without anyone asking, such as reacting when an entity changes, because a connector never starts on its own. In the conversation, run_action runs an action only when a request leads Claude to call it.