diff --git a/src/mcp/install-mcp-server.ts b/src/mcp/install-mcp-server.ts
index d5fac34..7ba781a 100644
--- a/src/mcp/install-mcp-server.ts
+++ b/src/mcp/install-mcp-server.ts
@@ -178,8 +178,9 @@ export async function prepareMcpConfig(
         core.warning(
           "The github_ci MCP server requires 'actions: read' permission. " +
             "Skipping CI server installation. " +
-            "To enable CI status checks, add 'actions: read' to your workflow permissions. " +
-            "See: https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token",
+            "To enable CI status checks, add 'actions: read' to your workflow permissions " +
+            "and set 'additional_permissions: actions: read' in the action's with: inputs. " +
+            "See: https://github.com/anthropics/claude-code-action/blob/main/docs/configuration.md#additional-permissions-for-cicd-integration",
         );
       } else {
         baseMcpConfig.mcpServers.github_ci = {
diff --git a/test/install-mcp-server.test.ts b/test/install-mcp-server.test.ts
index 152d2be..477b40f 100644
--- a/test/install-mcp-server.test.ts
+++ b/test/install-mcp-server.test.ts
@@ -292,6 +292,9 @@ describe("prepareMcpConfig", () => {
 
     const parsed = JSON.parse(result);
     expect(parsed.mcpServers.github_ci).not.toBeDefined();
+    expect(consoleWarningSpy).toHaveBeenCalledWith(
+      expect.stringContaining("Skipping CI server installation"),
+    );
 
     delete process.env.DEFAULT_WORKFLOW_TOKEN;
   });