Skip to main content

How to Set Up ChatGPT Integration

Connect AuditSwarm to ChatGPT for AI-assisted audit management.

Prerequisites

  • ChatGPT Plus or Team subscription
  • AuditSwarm account

Configuration

Configure via ChatGPT UI with these settings:

SettingValue
Plugin Manifesthttps://demo.auditswarm.com/.well-known/ai-plugin.json
Auth TypeOAuth 2.1 (Custom)
Authorization URLhttps://demo.auditswarm.com/api/oauth/authorize
Token URLhttps://demo.auditswarm.com/api/oauth/token

Setup Steps

Step 1: Access GPT Settings

  1. Open ChatGPT
  2. Navigate to Explore GPTs or My GPTs
  3. Click Create a GPT or edit an existing one

Step 2: Configure Actions

  1. In the GPT editor, go to Configure tab
  2. Click Add actions
  3. Select Import from URL
  4. Enter: https://demo.auditswarm.com/.well-known/ai-plugin.json

Step 3: Set Up Authentication

  1. Click Authentication
  2. Select OAuth
  3. Enter the authorization and token URLs above
  4. Click Save

Step 4: Test the Integration

  1. Click Preview
  2. Ask: "List my audits"
  3. Complete the OAuth login when prompted
  4. Verify you see audit data

Example Prompts

Once connected, try these prompts:

View Data:

  • "List all in-progress audits"
  • "Show risks with critical severity"
  • "What controls mitigate the authentication risk?"

Make Changes (via suggestions):

  • "Update the SOC2 audit status to In Progress"
  • "Create a new risk for SQL injection vulnerabilities"
  • "Mark the MFA control as implemented"

Get Help:

  • "How do I link a document?"
  • "What are the steps to create a workflow?"

Available Tools

Your ChatGPT has access to these AuditSwarm tools:

ToolWhat It Does
suggest_changeCreate/update/delete entities (requires approval)
query_dataQuery audits, risks, controls, workflows
get_current_contextSee what page user is viewing
helpGet platform guidance

See MCP Tools Reference for complete documentation.


Troubleshooting

OAuth Login Fails

Cause: Browser cookies or popup blocked.

Solution:

  1. Clear browser cookies for ChatGPT
  2. Ensure popups are allowed
  3. Try a private/incognito window

"Unauthorized" Errors

Cause: OAuth token expired.

Solution:

  1. Clear your ChatGPT session
  2. Re-authenticate with AuditSwarm

No Data Returned

Cause: You may not have any data in AuditSwarm.

Solution:

  1. Log into AuditSwarm directly
  2. Create some test audits/risks
  3. Try the ChatGPT query again

Next Steps