From 6713aa1fb4d616c02be4f0c26e1b9bdb4275efd7 Mon Sep 17 00:00:00 2001 From: Pages Coffie Date: Thu, 14 Aug 2025 16:46:35 +0000 Subject: [PATCH 1/5] add new video to mcp --- docs/ai-agents/port-mcp-server.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/docs/ai-agents/port-mcp-server.md b/docs/ai-agents/port-mcp-server.md index 664b2754c5..aff1902abe 100644 --- a/docs/ai-agents/port-mcp-server.md +++ b/docs/ai-agents/port-mcp-server.md @@ -14,7 +14,7 @@ import TabItem from "@theme/TabItem" style={{borderRadius:'4px'}} width="568" height="320" - src="https://www.youtube.com/embed/hxUTTPSApQs" + src="https://www.youtube.com/embed/WrVgQ-whBiE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" @@ -49,6 +49,21 @@ The Port MCP Server directly enables these kinds of valuable, in-context interac ## Key capabilities and use-cases +
+
+ +
+
+ The Port MCP Server enables you to interact with your Port data and capabilities directly through natural language within your chosen LLM-powered tools. Here's what you can achieve: ### Find information quickly @@ -95,8 +110,14 @@ Receive assistance with common development and operational tasks, directly withi * Ask: "Guide me through creating a new component blueprint with 'name', 'description', and 'owner' properties." * Ask: "Help me add a rule to the 'Tier1Services' scorecard that requires an on-call schedule to be defined." + ![Getting instructions for new service setup](/img/ai-agents/MCPClaudeServiceSetup.png) +### Find your own use cases + +You can use Port's MCP to find the use cases that will be valuable to you. Try using this prompt: "think of creative prompts I can use to showcase the power of Port's MCP, based on the data available in Port" + + ## Using Port MCP ### Setup From 8fec270d69052fdd3102e5be25e881fc7fa9a153 Mon Sep 17 00:00:00 2001 From: Pages Coffie Date: Thu, 14 Aug 2025 16:48:33 +0000 Subject: [PATCH 2/5] remove newline --- docs/ai-agents/port-mcp-server.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/ai-agents/port-mcp-server.md b/docs/ai-agents/port-mcp-server.md index aff1902abe..ba90551537 100644 --- a/docs/ai-agents/port-mcp-server.md +++ b/docs/ai-agents/port-mcp-server.md @@ -110,7 +110,6 @@ Receive assistance with common development and operational tasks, directly withi * Ask: "Guide me through creating a new component blueprint with 'name', 'description', and 'owner' properties." * Ask: "Help me add a rule to the 'Tier1Services' scorecard that requires an on-call schedule to be defined." - ![Getting instructions for new service setup](/img/ai-agents/MCPClaudeServiceSetup.png) ### Find your own use cases From 50e828c27a64d6a27fa6666f126b3ad1c7ce6171 Mon Sep 17 00:00:00 2001 From: Pages Coffie Date: Thu, 14 Aug 2025 17:02:10 +0000 Subject: [PATCH 3/5] add link to ai use cases --- docs/ai-agents/overview.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/ai-agents/overview.md b/docs/ai-agents/overview.md index f905b3f552..3c5ce1977f 100644 --- a/docs/ai-agents/overview.md +++ b/docs/ai-agents/overview.md @@ -89,6 +89,28 @@ The data model of AI agents includes two main blueprints: 2. **AI invocations** - Each interaction made with an AI agent is recorded as an invocation. This acts as a log of everything going through your AI agents so you can monitor and improve them over time. Learn more in our [Interact with AI agents](/ai-agents/interact-with-ai-agents) guide. +## Relevant Guides + +Explore these guides to see AI agents in action and learn how to implement them in your organization: + +- **[Generate incident updates with AI](/guides/all/generate-incident-updates-with-ai)** - Learn how to build an AI agent that generates incident updates and sends Slack notifications with relevant technical context. + +- **[Enrich tasks with AI-powered context](/guides/all/enrich-tasks-with-ai)** - Set up a "Task Assistant" AI agent that provides developers with automated, contextual insights when they start working on tasks. + +- **[Setup PR enricher AI agent](/guides/all/setup-pr-enricher-ai-agent)** - Create an AI agent that enriches pull requests with relevant context and information. + +- **[Setup service explorer AI agent](/guides/all/setup-service-explorer-ai-agent)** - Build an AI agent that helps developers explore and understand services in your catalog. + +- **[Setup platform request triage AI agent](/guides/all/setup-platform-request-triage-ai-agent)** - Implement an AI agent to automatically triage and route platform requests. + +- **[Setup task manager AI agent](/guides/all/setup-task-manager-ai-agent)** - Set up a Task Manager AI agent to help developers track and manage tasks efficiently. + +- **[Setup incident manager AI agent](/guides/all/setup-incident-manager-ai-agent)** - Set up an AI agent that helps developers track and manage incidents efficiently. + +- **[Add RCA context to AI agents](/guides/all/add-rca-context-to-ai-agents)** - Enhance your AI agents with root cause analysis context for better incident management. + +- **[Enrich security vulnerability using AI](/guides/all/enrich-security-vulnerability-using-ai)** - Use AI to automatically enrich security vulnerabilities with relevant context and remediation steps. + ## Frequently asked questions
From 64e37ad23a428972560d04b641d74e4a7a028464 Mon Sep 17 00:00:00 2001 From: Pages Coffie Date: Thu, 14 Aug 2025 17:06:13 +0000 Subject: [PATCH 4/5] add reference to incident solution --- .../incident-management/communicate-internally-and-externally.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/solutions/incident-management/communicate-internally-and-externally.md b/docs/solutions/incident-management/communicate-internally-and-externally.md index 7635a60dc6..4db8e124d3 100644 --- a/docs/solutions/incident-management/communicate-internally-and-externally.md +++ b/docs/solutions/incident-management/communicate-internally-and-externally.md @@ -25,6 +25,7 @@ In high-pressure moments, clear and timely communication prevents confusion, bui - [Create and Update Statuspage Incidents](../../guides/all/visualize-and-manage-statuspage-incidents#set-up-self-service-actions) - [Update ServiceNow Incident](../../guides/all/interact-with-servicenow/) - [Setup Incident Manager AI Agent](../../guides/all/setup-incident-manager-ai-agent) +- [Generate incident updates with AI](../../guides/all/generate-incident-updates-with-ai) :::tip Over-communicate in a Crisis When in doubt, share more. Frequent, clear updates—internally and externally—reduce stress and build trust during incidents. From 342aa34752a26172e9ec106abcda794f0a8999bf Mon Sep 17 00:00:00 2001 From: Pages Coffie Date: Fri, 15 Aug 2025 10:47:30 +0000 Subject: [PATCH 5/5] shorten links --- docs/ai-agents/overview.md | 28 ++++++++++------------------ 1 file changed, 10 insertions(+), 18 deletions(-) diff --git a/docs/ai-agents/overview.md b/docs/ai-agents/overview.md index 3c5ce1977f..31aa3e4697 100644 --- a/docs/ai-agents/overview.md +++ b/docs/ai-agents/overview.md @@ -89,27 +89,19 @@ The data model of AI agents includes two main blueprints: 2. **AI invocations** - Each interaction made with an AI agent is recorded as an invocation. This acts as a log of everything going through your AI agents so you can monitor and improve them over time. Learn more in our [Interact with AI agents](/ai-agents/interact-with-ai-agents) guide. -## Relevant Guides +## Relevant guides Explore these guides to see AI agents in action and learn how to implement them in your organization: -- **[Generate incident updates with AI](/guides/all/generate-incident-updates-with-ai)** - Learn how to build an AI agent that generates incident updates and sends Slack notifications with relevant technical context. - -- **[Enrich tasks with AI-powered context](/guides/all/enrich-tasks-with-ai)** - Set up a "Task Assistant" AI agent that provides developers with automated, contextual insights when they start working on tasks. - -- **[Setup PR enricher AI agent](/guides/all/setup-pr-enricher-ai-agent)** - Create an AI agent that enriches pull requests with relevant context and information. - -- **[Setup service explorer AI agent](/guides/all/setup-service-explorer-ai-agent)** - Build an AI agent that helps developers explore and understand services in your catalog. - -- **[Setup platform request triage AI agent](/guides/all/setup-platform-request-triage-ai-agent)** - Implement an AI agent to automatically triage and route platform requests. - -- **[Setup task manager AI agent](/guides/all/setup-task-manager-ai-agent)** - Set up a Task Manager AI agent to help developers track and manage tasks efficiently. - -- **[Setup incident manager AI agent](/guides/all/setup-incident-manager-ai-agent)** - Set up an AI agent that helps developers track and manage incidents efficiently. - -- **[Add RCA context to AI agents](/guides/all/add-rca-context-to-ai-agents)** - Enhance your AI agents with root cause analysis context for better incident management. - -- **[Enrich security vulnerability using AI](/guides/all/enrich-security-vulnerability-using-ai)** - Use AI to automatically enrich security vulnerabilities with relevant context and remediation steps. +- [Generate incident updates with AI](/guides/all/generate-incident-updates-with-ai) +- [Enrich tasks with AI-powered context](/guides/all/enrich-tasks-with-ai) +- [Setup PR enricher AI agent](/guides/all/setup-pr-enricher-ai-agent) +- [Setup service explorer AI agent](/guides/all/setup-service-explorer-ai-agent) +- [Setup platform request triage AI agent](/guides/all/setup-platform-request-triage-ai-agent) +- [Setup task manager AI agent](/guides/all/setup-task-manager-ai-agent) +- [Setup incident manager AI agent](/guides/all/setup-incident-manager-ai-agent) +- [Add RCA context to AI agents](/guides/all/add-rca-context-to-ai-agents) +- [Enrich security vulnerability using AI](/guides/all/enrich-security-vulnerability-using-ai) ## Frequently asked questions