Skip to content
Vendia

Enterprise Tier Setup Guide

This guide walks you through setting up Vendia MCP Server for Enterprise Tier users with projects and workspaces, enabling AI applications to access your distributed Vendia data in real-time.

Prerequisites

  • Active Vendia Project: A running project with the data you want to make accessible to AI applications
  • Vendia Account Access: Permissions to access your project settings and resources
  • MCP-Compatible AI Application: Such as Claude, ChatGPT, Mistral AI: Le Chat, OpenAI-compatible applications, or other MCP-enabled AI tools

Setup Steps

Step 1: Locate Your MCP Server URL

  1. Navigate to your Vendia project dashboard
  2. Go to Project Settings → Resources
  3. Find your “PROJECT MCP Server URL” - you’ll need this for configuration
  4. Copy the URL

Step 2: Configure Your AI Application

Add your project MCP Server URL to your AI application by following the detailed instructions in the Getting Started Guide.

Quick links for specific AI applications:

Step 3: Authenticate

When you first try to use the Vendia integration in your AI application:

  1. First Use: You’ll be directed to authenticate with your Vendia credentials
  2. OAuth Flow: Complete the OAuth authentication flow in your browser
  3. Return to AI App: Return to your AI application to start using your Vendia data

Your AI application will now have access to your Vendia data and can help you query, analyze, and work with your information.

For more information about authentication methods, see the Authentication Methods guide.

Verify Your Connection

After setup, verify the connection by:

  • Asking your AI application to list available GraphQL types
  • Running a simple operational (GraphQL) query against your project data
  • Testing analytical (SQL) capabilities on your data
  • Testing Vendia Files access and file operations
  • Testing file access from connected S3 buckets via Storage Connections

For a complete list of available tools and capabilities, see Overview - Available Tools.

Troubleshooting

”Vendia” Option Not Appearing

  • Ensure you’ve completely restarted your AI application (e.g., Claude)
  • Verify your project MCP Server URL is correct
  • Check that the MCP Server URL is accessible from your network

Authentication Issues

  • Verify your Vendia credentials are correct
  • Ensure your account has access to the specified project
  • Check that popup blockers aren’t preventing the authentication window

For more information about authentication methods, see the Authentication Methods guide.

Connection Errors

  • Confirm the MCP Server URL is correct and accessible
  • Verify your network connection allows access to the Vendia servers
  • Check if corporate firewalls are blocking the connection

Data Access Issues

Project Data Issues:

  • Ensure your Vendia account has appropriate permissions for the data you’re trying to access
  • Verify the project contains the expected data and schema
  • Check that your workspace has the necessary access rights

Storage Connection Issues:

  • Verify your cross-account IAM role has the correct S3 permissions
  • Check that your storage connection configuration is correct
  • Ensure your S3 bucket contains accessible files

For detailed troubleshooting, see Storage Connections - Troubleshooting.

Next Steps

Now that you have Vendia MCP Server configured with your AI application, you can:

  1. Explore Your Projects: Ask your AI application to show you what data types and structures are available in your projects
  2. Run Operational Queries: Execute GraphQL queries for real-time data operations and mutations
  3. Run Analytical Queries: Execute SQL queries for data analysis and reporting
  4. Work with Vendia Files: Upload, manage, and access files stored directly in your Vendia projects
  5. Set Up Storage Connections: Configure read and write access to external S3 buckets using the Storage Connections guide
  6. Build Applications: Use your AI application to help develop applications that leverage operational data, analytical insights, Vendia Files, and S3 data
  7. Create Reports: Generate comprehensive insights and reports based on your structured and unstructured data, or save them to S3

Advanced Connection Methods

Need alternative connection methods beyond direct remote MCP? See the Advanced Connection Methods guide for:

  • Local proxy connections (for legacy MCP clients)
  • Programmatic access with service credentials
  • Custom token exchange implementations

Need Help?

The Vendia team is here to help you make the most of AI-powered access to your distributed data!