AWS Security ChangesHomeSearch

AWS clean-rooms medium security documentation change

Service: clean-rooms · 2026-05-16 · Security-related medium

File: clean-rooms/latest/userguide/troubleshooting.md

Summary

Added new section 'Using AWS MCP to troubleshoot Clean Rooms issues' with focus on diagnosing permission errors and missing CloudWatch logs for ML jobs. Restructured existing issue headings from ## to ###.

Security assessment

Explicitly addresses permission errors including IAM policies, KMS keys, and cross-account access which are core security controls. Provides troubleshooting for security-sensitive areas like access control and audit logging.

Diff

diff --git a/clean-rooms/latest/userguide/troubleshooting.md b/clean-rooms/latest/userguide/troubleshooting.md
index 723c417d2..70f0117cd 100644
--- a//clean-rooms/latest/userguide/troubleshooting.md
+++ b//clean-rooms/latest/userguide/troubleshooting.md
@@ -7 +7 @@
-One or more tables referenced by the query is not accessible by its associated service role. The table/role owner must grant the service role access to the table.One of the underlying datasets has an unsupported file format.Query results are not as expected when using Cryptographic Computing for Clean Rooms.AWS Clean Rooms Spark SQL: Missing partition data
+Using AWS MCP to troubleshoot Clean Rooms issuesCommon issues
@@ -10,0 +11,17 @@ One or more tables referenced by the query is not accessible by its associated s
+If you encounter issues while using AWS Clean Rooms, you can use the AWS MCP Server to automatically diagnose problems, or refer to the common issues listed in the topics below for manual resolution.
+
+## Using AWS MCP to troubleshoot Clean Rooms issues
+
+You can use the [AWS MCP Server](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/mcp-server.html) with any MCP-compatible client to automatically diagnose and resolve common Clean Rooms issues. The aws-cleanrooms skill can help with the following:
+
+  * **Permission errors** – Access denied errors when running protected queries, writing results, accessing configured tables, or performing cross-account operations. The skill systematically checks IAM role policies, S3 bucket policies, KMS key policies, Lake Formation permissions, and cross-account trust configuration.
+
+  * **Missing CloudWatch logs for custom ML model jobs** – CloudWatch logs not appearing for custom model training or inference jobs. The skill checks privacy configuration, ML Configuration setup, role permissions, and log group existence.
+
+
+
+
+To get started, install and configure the AWS MCP server. For setup instructions, see the [AWS MCP Server Setup](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html) guide.
+
+## Common issues
+
@@ -26 +43 @@ This section describes some common issues that might arise when using AWS Clean
-## One or more tables referenced by the query is not accessible by its associated service role. The table/role owner must grant the service role access to the table.
+### One or more tables referenced by the query is not accessible by its associated service role. The table/role owner must grant the service role access to the table.
@@ -33 +50 @@ This section describes some common issues that might arise when using AWS Clean
-## One of the underlying datasets has an unsupported file format.
+### One of the underlying datasets has an unsupported file format.
@@ -58 +75 @@ For more information, see [Data formats for AWS Clean Rooms](./data-formats.html
-## Query results are not as expected when using Cryptographic Computing for Clean Rooms.
+### Query results are not as expected when using Cryptographic Computing for Clean Rooms.
@@ -73 +90 @@ For more information, see [Cryptographic Computing for Clean Rooms](./crypto-com
-## AWS Clean Rooms Spark SQL: Missing partition data
+### AWS Clean Rooms Spark SQL: Missing partition data