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:
| Setting | Value |
|---|---|
| Plugin Manifest | https://demo.auditswarm.com/.well-known/ai-plugin.json |
| Auth Type | OAuth 2.1 (Custom) |
| Authorization URL | https://demo.auditswarm.com/api/oauth/authorize |
| Token URL | https://demo.auditswarm.com/api/oauth/token |
Setup Steps
Step 1: Access GPT Settings
- Open ChatGPT
- Navigate to Explore GPTs or My GPTs
- Click Create a GPT or edit an existing one
Step 2: Configure Actions
- In the GPT editor, go to Configure tab
- Click Add actions
- Select Import from URL
- Enter:
https://demo.auditswarm.com/.well-known/ai-plugin.json
Step 3: Set Up Authentication
- Click Authentication
- Select OAuth
- Enter the authorization and token URLs above
- Click Save
Step 4: Test the Integration
- Click Preview
- Ask: "List my audits"
- Complete the OAuth login when prompted
- 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:
| Tool | What It Does |
|---|---|
suggest_change | Create/update/delete entities (requires approval) |
query_data | Query audits, risks, controls, workflows |
get_current_context | See what page user is viewing |
help | Get platform guidance |
See MCP Tools Reference for complete documentation.
Troubleshooting
OAuth Login Fails
Cause: Browser cookies or popup blocked.
Solution:
- Clear browser cookies for ChatGPT
- Ensure popups are allowed
- Try a private/incognito window
"Unauthorized" Errors
Cause: OAuth token expired.
Solution:
- Clear your ChatGPT session
- Re-authenticate with AuditSwarm
No Data Returned
Cause: You may not have any data in AuditSwarm.
Solution:
- Log into AuditSwarm directly
- Create some test audits/risks
- Try the ChatGPT query again
Next Steps
- MCP Tools Reference - Learn what your GPT can do
- How to Approve Suggestions - Handle AI suggestions
- Suggestions Pattern - Understand AI safety