Razuna AI Assistant Integration
Connect your favorite AI assistants (Claude, ChatGPT, or Raycast AI) directly to your Razuna Digital Asset Management system. Search, organize, and manage your files using natural language—no need to switch between apps.
What You Can Do
Once connected, you can have natural conversations with AI assistants about your Razuna files:
Search and Find Files
- "Show me all PDF documents from last month" - Find files by type and date
- "Find product images with blue backgrounds" - Semantic search understands visual content
- "Show me files from John Smith in the Marketing folder" - Search by owner and location
- "What are the largest files in my workspace?" - Query by file properties
- "Find images with 2 people in business attire" - AI understands image content
- "Show me files with Project: Alpha custom field" - Search custom metadata
Organize and Manage
- "Create a new folder called 'Q1 2026 Campaign'" - Organize your workspace
- "Move these files to the Archive folder" - Reorganize assets
- "Update the description of logo.png to 'Company logo 2026'" - Edit metadata
- "Tag these images with 'approved' and 'final'" - Add labels
- "Create a collection of all product images" - Group related files
Share and Collaborate
- "Create a share link for presentation.pdf" - Generate shareable links
- "Share these files with download enabled" - Control access permissions
- "Make a 7-day expiring link for client-review.jpg" - Time-limited sharing
Upload and Analyze
- "Upload this file to the Marketing folder" - Add new assets
- "Analyze this image and tell me what's in it" - AI content analysis
- "Find images similar to logo.png" - Visual similarity search
Follow-up Questions
The AI maintains context across questions, so you can have natural conversations:
- "Show me product images" → (AI returns 50 images)
- "Which ones are PNG files?" → (AI filters from previous results)
- "Show me the 5 largest" → (AI sorts and limits)
- "Create a share link for the first one" → (AI acts on specific file)
Setup Instructions
To connect your AI assistant to Razuna, you'll need:
- Your Razuna server URL (e.g.,
https://mcp.razuna.com/sseorhttps://mcp.razuna.eu/sse) - An Access Token from your Razuna account
Getting Your Access Token
- Log in to your Razuna account
- Click your profile icon in the top right
- Select Settings → Access Tokens
- Click Create New Token
- Give it a name like "AI Assistant"
- Copy the token and save it securely (you won't see it again)
Configuration by AI Assistant
Claude Desktop
Claude Desktop supports connecting to remote MCP servers, but only through the Integrations feature in the settings, not directly via the claude_desktop_config.json file. Remote MCP servers are available for users on Pro, Max, Team, and Enterprise plans.
Step 2: Add MCP Integration
- Click Add Integration
- Select Model Context Protocol (MCP)
- Choose Remote Server as the connection type
Step 3: Configure Connection
Enter the following details:
| Field | Value |
|---|---|
| Server Name | Razuna DAM |
| Server URL | https://mcp.razuna.com/sse |
| access-token | your_access_token_here |
(Remember to replace mcp.razuna.com with mcp.razuna.eu if you use our EU data center)
Step 3: Restart Claude Desktop
Quit and reopen Claude Desktop. You should see a small 🔌 icon indicating the Razuna connection is active.
Step 4: Test the Connection
Try asking Claude: "List my Razuna workspaces"
Raycast AI
Step 1: Open Raycast Settings
- Open Raycast (⌘ + Space)
- Type "Settings" and press Enter
- Navigate to Extensions → AI
Step 2: Add MCP Server
- Scroll to the Model Context Protocol section
- Click Add Server
- Enter the following details:
| Field | Value |
|---|---|
| Name | Razuna |
| Type | Remote (SSE) |
| URL | https://mcp.razuna.com/sse |
| access-token | your_access_token_here |
(Remember to replace https://mcp.razuna.com with https://mcp.razuna.eu if you use our EU data center)
Step 3: Enable the Server
Toggle the switch to enable the Razuna MCP server.
Step 4: Test the Connection
Open Raycast AI Chat and ask: "Search my Razuna files"
ChatGPT Desktop
To use remote MCP servers in Chat mode, users must first enable Developer Mode in their ChatGPT settings, which is available for ChatGPT Pro, Team, Enterprise, and Edu users.
Step 1: Open ChatGPT Settings
- Open ChatGPT Desktop app
- Click the Settings icon (⚙️) in the bottom left
- Select Integrations
Step 2: Add MCP Integration
- Click Add Integration
- Select Model Context Protocol (MCP)
- Choose Remote Server as the connection type
Step 3: Configure Connection
Enter the following details:
| Field | Value |
|---|---|
| Server Name | Razuna DAM |
| Server URL | https://mcp.razuna.com/sse |
| access-token | your_access_token_here |
(Remember to replace https://mcp.razuna.com with https://mcp.razuna.eu if you use our EU data center)
Step 4: Verify and Save
- Click Test Connection to verify
- If successful, click Save
- The integration will appear in your integrations list with a green status indicator
Step 5: Test the Connection
Start a new chat and ask: "What workspaces do I have in Razuna?"
Tips for Best Results
Be Specific
Instead of "find images," try "find product images from last week in the Marketing folder."
Use Natural Language
You don't need technical syntax. Ask questions like you would to a colleague.
Reference Previous Results
The AI remembers context: "Show me PDFs" → "Now show just the ones from December" works perfectly.
File Type Searches
Be explicit: "files with extension PDF" or "show all PNG images" works better than just "documents."
Custom Fields
Mention field names: "files with Status: Approved" or "show images where Project equals Alpha."
Security and Privacy
- Access Control: The AI can only access files you have permission to view
- Token Security: Keep your access token private—it provides full access to your Razuna account
- Revoke Access: You can revoke tokens anytime in Razuna Settings → Access Tokens
- Audit Trail: All actions through the AI are logged in your Razuna activity history
Troubleshooting
Connection Issues
Problem: AI says it can't connect to Razuna
- Verify your MCP server URL is correct and accessible
- Check that your access token hasn't expired or been revoked
- Restart your AI assistant application
Permission Errors
Problem: "You don't have permission" errors
- The AI respects your Razuna permissions—if you can't access a folder in Razuna, the AI can't either
- Ask your administrator to grant you access to the workspace or folder
Search Returns No Results
Problem: Searches that should find files return nothing
- Try more specific file type queries: "files with extension pdf" instead of "documents"
- Check if files have been indexed—new uploads may take a moment to appear in search
- Verify you're searching in the correct workspace
Support
Need help? Contact your Razuna administrator or reach out to Razuna support with details about your issue.