Guides
Learn Port by building. Real guides for real workflows.
NEW
Build your Port catalog with AI (MCP)
Use Port's MCP server to build catalog structure, actions, automations, and scorecards through natural language conversations with AI
NEW
AI-powered incident management
Implement an AI-powered incident lifecycle with triage, orchestration, incident updates, RCA context, and postmortems
Smart PR reviewer assignment using AI
Automatically assign qualified PR reviewers based on CODEOWNERS, ownership, and capacity using Port AI
Promote to production workflow
Deploy to production with Port Workflows or GitHub Actions, safety checks, incident creation, and team notifications
Auto-enhance PR descriptions with AI
Automatically generate comprehensive, template-compliant PR descriptions using a Port workflow that gathers catalog context and dispatches a coding agent
Summarize Zendesk tickets with AI
Build a workflow that fetches ticket context and summarizes it with Port AI
NEW
Provision cloud resources with an agentic IaC workflow
Build a self-service workflow that drafts an IaC implementation plan with AI and opens a real pull request against your GitOps repository using a Cursor Agent node
NEW
Trigger Datadog incident (Workflows)
Trigger a Datadog incident from a self-service workflow and sync it to your catalog
NEW
Create Slack channel for reported incident
Automatically open a Slack channel and GitHub issue when a PagerDuty incident is reported
NEW
Respond to New Relic alerts
Create Jira issues or PagerDuty incidents from New Relic alerts using Port workflows with webhook nodes
NEW
Visualize and manage Git deployments
Create dashboards and self-service actions to visualize and manage GitHub and GitLab deployments
NEW
Prepare work items with AI
Enrich work items with catalog context, support human review, and route approved tickets to coding agents
NEW
Manage Argo CD applications
Create self-service actions that sync and restart Argo CD applications
NEW
Nudge Pull Request Reviewers
Create a Port workflow that nudges reviewers of a pull request
NEW
Assign PR reviewers with a Claude managed agent
Assess pull request risk, assign reviewers, comment, and auto-approve low-risk PRs using a Claude managed agent triggered from a Port workflow
NEW
Map external users to Port accounts
Map Git, Jira, Slack, ServiceNow, and HiBob users to Port user accounts
NEW
Manage incident lifecycle
Create self-service actions to acknowledge, escalate, and resolve PagerDuty incidents
NEW
Add tags to AWS resources
Create self-service actions that add tags to AWS S3 buckets and ECR repositories
NEW
Manage Humanitec applications
Ingest Humanitec resources and manage applications with self-service actions
NEW
Deploy Azure resource with Terraform
Create self-service actions that deploy Azure storage accounts with Terraform using GitHub Actions, Azure DevOps, or Jenkins
NEW
Manage MCP Server Registry
Build a centralized MCP server registry with governance, discovery, and automated metadata extraction
NEW
Set up a PRD agent for ticket triage
Set up a PRD agent, a PM agent running a PRD skill, that turns thin tickets into a clear spec and routes each one to an AI coding agent or a human
NEW
Trigger AI coding assistants from Port
Trigger GitHub Copilot, Claude Code, and Google Gemini Assistant from Port using governed workflows
NEW
Scaffold a new service
Create a workflow that scaffolds a new service and registers it in your catalog
NEW
Sync Port configurations between environments using Port AI and MCP
Move Port configurations between environments using Port AI and GitHub MCP
Remediate CI/CD failures with Port AI & Cursor
Remediate CI/CD failures with a Port workflow that gathers catalog context, launches a Cursor agent, and notifies Slack
Route scorecard failures to Jira issues with AI
Route scorecard failures to Jira issues using a Port workflow and Port AI
Onboard developers using internal docs and Port MCP
Onboard developers from internal docs using Port MCP to help new developers get up to speed quickly
Sync Port properties to GitHub custom properties
Sync Port properties to GitHub custom properties using Port's GitHub integration and automation system
Surface resource actions from Jira with AI
Use Port's AI agent to analyze Jira issues and surface relevant self-service actions for cloud resources and permissions
Migrate repositories from GitHub to GitLab
Migrate repositories from GitHub to GitLab using Port self-service actions and GitHub Actions
Implement the incident blueprint pattern
Learn the recommended pattern for managing incident response workflows using a dedicated incident blueprint
Track Azure resource tagging compliance
Track Azure resource tagging compliance with scorecards, dashboards, and self-service remediation
Measure AI feedback
Collect and analyze feedback on AI tools using Port actions, automations, and AI agents to measure effectiveness and guide adoption decisions
Implement the work item blueprint pattern
Learn the recommended pattern for managing development workflows using a dedicated work item blueprint
Calculate blast radius with AI
Calculate deployment blast radius and production risk using AI, service dependencies, and Port self-service actions.
Centralize AI coding rules with Port
Use a workflow to centralize AI coding rules with Port and sync consistent standards into repository AGENTS.md files
Auto-assign bugs to owners with AI
Automatically assign Jira bugs to owning teams and services with Port automations and AI
Auto-generate GitHub workflow documentation
Automatically generate and maintain human-readable documentation for GitHub Actions workflows using Port's AI agents and automation system
Query DORA metrics using Port MCP
Query DORA metrics using natural language commands directly from your IDE with Port's MCP server
Streamline IaC with AI
Use Port AI agents to automate IaC provisioning and management
Auto-heal unhealthy Kubernetes pods with Port workflows
Detect unhealthy Kubernetes workloads and automatically diagnose and fix them with a single Port workflow and Port AI
Manage AI instructions with Port
Learn how to centralize AI instructions in Port and automatically sync them to GitHub repositories
Interact with PagerDuty incidents
Create self-service actions that create, trigger, reassign, and resolve PagerDuty incidents
Map PRs to services in a monorepo
Automatically map GitHub pull requests to services in a monorepo using file path analysis
Send Slack messages using Port's Slack app and automations
Learn how to send Slack messages to users using Port's Slack app and automations
Auto-fix services when scorecards degrade
Learn how to use Port's AI capabilities to detect scorecard degradation and automatically use a coding agent like GitHub Copilot to fix it
Visualize and manage your Azure DevOps deployments
Create a dashboard that visualizes and manages your Azure DevOps deployments
Manage your Kubernetes deployments
Manage Kubernetes deployments and pods with self-service actions for restarts, replica changes, and pod deletion
Manage EKS clusters
Create self-service actions to create, request, deploy to, tag, and delete EKS clusters
Set up the Platform Request Triage AI agent
Set up an AI agent that helps developers submit and track requests to the platform team
Automatically set relations between entities with automation
Set up automations to set relations between entities based on integrations metadata
Manage and visualize your Jira issues
Manage Jira issues with dashboards, automatic labels, status updates, assignee changes, and comments
Manage PagerDuty on-call schedules
Track and manage on-call engineers across teams and services with Port workflows and dashboards
Manage and visualize your PagerDuty incidents
Manage your PagerDuty incidents with self-service actions and create dashboards for visualization
Manage and visualize your LaunchDarkly feature flags
Create a comprehensive feature flag management system to create, toggle, and archive flags
Visualize and manage your Statuspage incidents and components
Create a dashboard that visualizes and manages your Statuspage incidents and components
Visualize and manage your ServiceNow incidents
Create a dashboard that visualizes and manages your ServiceNow incidents
Auto-label your GitHub PRs with Sonar Scans
Create an automation that applies labels to GitHub pull requests based on SonarQube scans
Automate admin role assignment
Set up automated user role assignment when they are added to Admins group.
Interact with ServiceNow records and incidents
Create self-service actions that create, update, trigger, and delete ServiceNow records and incidents
Notify users upon approval of self-service actions
Create an automation that notifies users when a self-service action is approved/declined
Automatically create Jira issue from Datadog alert
Create an automation that creates a Jira issue from a Datadog alert
Trigger Spacelift stack
Create a self-service action that triggers a Spacelift stack to automate infrastructure workflows
Enrich pull requests using AI
Set up an AI agent that automatically comments on pull requests with additional context
Set up the Task Manager AI agent
Set up a Task Manager AI agent to help developers track and manage tasks efficiently
Create an incident.io Incident
Create a self-service action that creates an incident.io incident
Copy ADO Pipeline Template to Target Repo
Create a self-service action that copies an AzureDevops pipeline template to a target repository
Manage service deployments using GitLab and ServiceNow
Create a chain of self-service actions that deploy a service using GitLab and ServiceNow
Automatically approve actions using an automation
Set up automated approvals for self service actions
Manage Kubernetes namespaces via a Port workflow
Create and manage Kubernetes namespaces with GitLab pipelines, approval workflows, and automations
Automate Slack alerts for Overdue PRs
Send a Slack notification for pull requests that have been open longer than a specified time using an automation
Create cloud resources using IaC
Create a self-service action that provisions cloud resources from a pre-defined template in your Git repository
Visualize your services' k8s runtime
Create views to track the health, status, and other standards of your services' k8s runtime
Visualize your services' k8s runtime using ArgoCD
Create views to track the health, status, and other standards of your services' k8s runtime using ArgoCD
Enrich services using Gitops
Empower developers to independently enrich their services using a self-service action
Slack reminders for scorecards
Send a Slack reminder for uncompleted scorecard rules using a self-service action
IAM permission management
Empower developers to independently enrich their services using a self-service action
Manage GitHub Pull Requests
Create a Port workflow that dispatches a GitHub Actions pipeline to close, merge, or approve pull requests
Deploy/rollback using ArgoCD
Create a self-service action that performs a deployment/rollback using ArgoCD
Create an AWS EC2 instance
Create a self-service action that provisions an AWS EC2 instance with Terraform using GitHub Actions or GitLab CI
Deploy S3 Bucket using Crossplane
Create a self-service action that deploys Crossplane resources in your Kubernetes cluster
Provision Cloud Resource using Terraform
Create a self-service action that provisions cloud resources using Terraform
Trigger Datadog Incident
Create a self-service action that triggers a Datadog incident
Report a bug to Jira
Create a self-service action that reports a bug to Jira using webhook, GitHub, or GitLab
Automate AWS Account Creation with GitLab
Create a self-service action that creates an AWS account
Scaffold repositories using Cookiecutter
Create a self-service action that scaffolds GitHub, Bitbucket, or Azure DevOps repositories using a Cookiecutter template
Scaffold a new service with Actions
Create a self-service action that scaffolds a new service and can open follow-up GitOps pull requests
Lock and Unlock Services
Create a self-service action that locks and unlocks a service
Create a Jira Issue
Create a self-service action that creates a Jira issue
Manage FireHydrant incidents
Create a self-service action that manages FireHydrant incidents
Enrich tasks with AI-powered context
Use Port workflows to enrich Jira tasks with AI-powered context for task assignees
Create an actions ROI dashboard
Create a dashboard that tracks the ROI of actions in Port
Find internal documentation with AI
Find internal documentation using AI by storing documentation as entities in your Port catalog
NEW
Manage and visualize cloud resources
Manage and visualize AWS, Azure, and GCP cloud resources with dashboards and self-service actions
NEW
Ingest cloud resources using APM integrations
Ingest cloud resources monitored by Datadog, Dynatrace, or New Relic into Port
NEW
Ingest data via Airbyte and S3
Ingest HiBob or Okta data using Airbyte, S3, and a custom webhook integration
NEW
Ingest repository files into your context lake
Parse package manifests, API specifications, SBOMs, SARIF files, and security scan results from repositories into Port
NEW
Build GitHub dashboards in Port
Build GitHub dashboards for dependency security, identity and access, repository activity, and engineering metrics
NEW
Visualize Cursor metrics
Create dashboards to monitor Cursor adoption, acceptance rates, and engineering impact at the user, team, and organization level
NEW
Visualize Claude metrics
Create dashboards to monitor Claude API usage, track costs, analyze model performance, and measure workspace-level metrics
NEW
Measure GitHub Copilot adoption and usage with plugins
Deploy the GitHub Copilot AI Adoption and Usage plugin to track Copilot adoption, acceptance rates, and AI-generated insights in Port
NEW
Create Survey Intelligence
Deploy the Survey Builder, Forms, and Analytics plugins to run engineering surveys and turn responses into insights
Build an AI Agent Registry
Build a centralized AI Agent Registry to discover, govern, and manage AI agents across AWS Bedrock and Azure AI Foundry
Manage and surface technical documentation
Centralize markdown technical docs in Port by syncing them from a Git source, displaying them on service pages, and optionally adding a TechDocs plugin
Create foundational Engineering Intelligence data model
Build the foundational data model for Engineering Intelligence with organizations, teams, services, and repository blueprints
Triage incidents using Dynatrace MCP
Triage incidents using AI, Dynatrace MCP, GitHub MCP, and Slack to build root-cause summaries from live telemetry and code context.
Ingest .NET framework versions
Track .NET framework versions across repositories by ingesting .csproj files into Port
Keep your Azure catalog up to date with incremental syncing
Keep your Azure catalog data up to date by syncing only what changed, without full rescans
Triage incidents using external MCP tools
Triage incidents using AI, Sentry MCP, GitHub MCP, and Slack — fetch live errors, query code context, and post a structured root-cause summary directly from Port AI.
Set up delivery performance scorecard
Define and track delivery performance standards across services, teams, groups, and organizations using scorecards
Set up pipeline reliability scorecards
Grade services, teams, groups, and organizations on CI/CD workflow failure rates and reliability trends using Bronze, Silver, and Gold maturity levels
Set up a service production readiness scorecard
Grade services on ownership, documentation and repository hygiene
Visualize lead time using Jira
Track and visualize Jira lead time metrics at the service and team level with weekly and monthly averages
Measure pipeline reliability
Measure CI/CD pipeline reliability at service and team level including failure rates, failure trends, and failing workflow identification
Measure PR delivery metrics
Measure PR delivery metrics at service and team level including cycle time, throughput, stale PRs, and reviewer coverage
Track team work allocation with Jira
Measure and visualize work allocation across Roadmap, Tech Debt, and Support categories at the team level using Jira labels
Measure sprint health with Jira
Track sprint completion rate, scope change, and carryover at the team level using dashboards and scorecards
Ingest prompts and skills from GitHub using GitOps
Ingest prompts and skills from GitHub using GitOps by mapping repo files to Port blueprints.
Ingest Claude Code security reviews
Ingest Claude Code security reviews into Port using Port's GitHub file ingesting feature
Visualize Okta security insights
Build a security analytics dashboard for Okta identity and access management
Visualize GitHub Copilot metrics
Create dashboards to monitor GitHub Copilot usage, track acceptance rates, and measure team productivity
Track AI adoption and impact
Track AI adoption and impact across your engineering teams and assess the impact of AI usage on delivery metrics like PR throughput and cycle time
RBAC for AI agents with n8n and Port
Implement role-based access control (RBAC) for multi-agent systems using Port and n8n, enabling dynamic tool access control for AI agents based on user roles and permissions
Automatically resolve tickets with n8n and Port context
Automatically resolve tickets with n8n and Port context using Port's AI agents and automations
PCI DSS code security scorecard
Continuously track compliance with PCI DSS requirements using code scans and vulnerability data
Enforce AI coding security standards
Learn how to enforce AI coding security standards in your organization
Build an OWASP Top 10 Scorecard
Build an OWASP Top 10 security scorecard in Port using vulnerability data from Snyk
Auto-remediate insecure cloud resources with AI
Learn how to use Port's AI capabilities to detect insecure cloud resources and automatically use a coding agent like Claude Code to fix it
Track AI-driven pull requests
Track AI-driven pull requests and visualize them in a dashboard
Track and show MTBF for services
Track Mean Time Between Failures (MTBF) for your services to measure reliability and identify improvement opportunities
Set up the Service Explorer AI agent
Set up an AI agent with MCP server backend mode that helps developers explore and understand your context lake
Set up DORA metrics using Jira
Configure DORA metrics tracking using Jira for both deployments and incidents
Visualize your Wiz vulnerabilities
Create a dashboard that visualizes your Wiz vulnerabilities
Track health of Jira projects using scorecards
Create a scorecard to track the health of Jira projects
Enforce code maturity with GitLab file search
Create a scorecard that tracks GitLab code maturity based on file existence
Set up the Incident Manager AI agent
Set up an AI agent that helps developers track and manage incidents efficiently
Enforce Branch Protection Rules with Scorecards
Create a scorecard that tracks branch protection rules and enforces security policies
Ingest Slack data into Port
Ingest Slack channels, users, and memberships through Airbyte or Fivetran, S3, and a webhook integration
Ingest vulnerability alerts from Orca Security
Ingest vulnerability alerts from Orca Security using a custom webhook integration
Sync Service Entities to incident.io
Create a GitHub action that syncs service entities to your incident.io catalog
Track DORA metrics
Set up DORA metrics, dashboards, and scorecards for services and teams
Ensure production readiness
Define and track metrics for your services to ensure their production readiness
Auto-create Slack channel & GitHub issue for PagerDuty incidents
Create Slack channels and GitHub issues for PagerDuty incidents, automatically or manually
Connect GitHub pull request with Jira Issue
Create a logical connection between your GitHub PRs and their corresponding Jira issues
Connect CODEOWNERS with Service, Team & User
Create a logical connection between your GitHub CODEOWNERS and their corresponding services, teams, and users
Create and manage Kubernetes clusters
Create Kubernetes clusters using Crossplane & ArgoCD
Measure pull request standards
Implement working agreements and measure pr standards
Remediate vulnerabilities with AI
Use Port AI agents with Claude Code to remediate security vulnerabilities and trigger automated fixes
Monitor integrations
Monitor and manage your Port Ocean integrations
Track leaked GitHub secrets in Port
Create a webhook integration that tracks leaked GitHub secrets in Port
Automatically resolve tickets with coding agents
Learn how to create an AI agent that automatically resolves tickets with coding agents
Remediate security vulnerability with n8n and Port AI
Remediate security vulnerabilities with n8n and Port AI using Port's AI agents and automations
Track AI coding assistants costs
Build a unified dashboard to analyze and compare AI coding tool costs across Cursor, Claude, and GitHub Copilot
Ingest Swarmia metrics into your context lake
Ingest metrics from Swarmia into Port using a scheduled GitHub Actions workflow to establish a single source of truth for engineering performance data
Ingest LinearB metrics into your context lake
Ingest metrics from LinearB into Port using the Ocean Custom Integration to consolidate DORA and pull request performance data into a single source of truth
Ingest GitLab security vulnerabilities into your context lake
Ingest GitLab SAST, DAST, dependency scanning, and container scanning vulnerabilities into Port for centralized security posture visibility and team-level insights