# setup-service-scanner

Creates a scanner configuration to discover services (such as AI agents, MCP servers, and API metadata) from external platforms like AWS Bedrock, Microsoft Copilot, or Google Vertex AI. Use when setting up scanner discovery, configuring a new scanner, connecting to cloud AI platforms, or importing discovered services into Anypoint Exchange.

- **APIs:** [access-management](https://dev-portal.mulesoft.com/apis/access-management.md), [agent-scanner-configuration-service](https://dev-portal.mulesoft.com/apis/agent-scanner-configuration-service.md)- **Skill Source:** [SKILL.md](https://dev-portal.mulesoft.com/skills/setup-service-scanner/SKILL.md)

## Steps
### Step 1: Step 1: Get Available Target Systems
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `getTargetSystems`
**Inputs:**
- `organizationId` — Your organization's Business Group GUID

**Outputs:**
- `targetSystemId` (`$[*].id`) — The target system ID to use when creating a connection
- `targetSystemType` (`$[*].type`) — The target system type (e.g., bedrock, mscopilot, vertex)

### Step 2: Step 2: Validate Connection Credentials
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `testConnection`
**Inputs:**
- `organizationId` — Same organization ID as Step 1
- `targetSystemType` — Target system type from Step 1 (for example, bedrock, mscopilot, vertex)
- `requestBody` — Connection test parameters including:
- authScheme: Authentication scheme (e.g., "accessKey", "oauth2")
- authParameters: JSON with credentials (varies by platform)


### Step 3: Step 3: Create Scanner Configuration
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `createScanConfigurations`
**Inputs:**
- `organizationId` — Same organization ID as previous steps
- `requestBody` — Scanner configuration including:
- name: Display name for the scanner
- schedule: JSON schedule configuration
- runPolicy: JSON run policy (can be empty object)
- connection: Object with connection details
- notificationEnabled: Whether to send email notifications


**Outputs:**
- `scannerConfigurationId` (`$.id`) — The UUID of the created scanner configuration
- `scannerState` (`$.state`) — The current state of the scanner (e.g., SCHEDULED, STOPPED)