• LOOKUP
  • SHIPPING
  • TRIAGE
  • HUMAN

How to manage customer profiles with your AI

Connect Medusa to your AI client to pull real-time customer data. You'll get instant access to profiles and addresses without switching tabs.

Ask AI about this page

Short answer

How can I look up customer info with my AI?

Your AI uses Medusa tools to find specific customer profiles and their shipping details. This lets you answer support questions about where an order is going or who placed it immediately. You'll see exactly how the data flows below.

Data outcomes

Customer data outcomes

What happens when you ask your AI for customer info.

LOOKUP

Instant profile access

The AI finds the right person in your Medusa store. You get their contact info and account details right in your chat.

SHIPPING

Address verification

Your agent pulls the exact shipping address on file. This helps you confirm delivery details during a support call.

TRIAGE

Support readiness

The AI gathers all necessary customer context before you even reply. You'll have the facts ready to resolve the issue.

HUMAN

Manual intervention

If a customer needs a profile change or a refund, you'll handle that yourself. The AI only reads the existing data.

The workflow

What your AI does when a support request arrives.

The AI handles the data retrieval so you can focus on the conversation.

  1. Identify the customer

    Your agent scans your Medusa store to find the person mentioned in the chat.

    list_customers

  2. Pull specific details

    Once the customer is identified, the AI grabs their full profile and address.

    get_customer

  3. Verify information

    The AI compares the requested info against the data in Medusa to ensure accuracy.

    get_customer

  4. Present findings

    The AI shows you the customer's name, email, and address in your chat interface.

    get_customer

Try it

Copy these to start.

Use these prompts to interact with your Medusa data.

Starting points

These are basic starting points. Swap out the names and emails for the actual people you're looking for.

MedusaJS Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — MedusaJS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "medusa-headless-e-commerce-engine-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}
Copy into chat04

  • Find the customer with the email alex.smith@example.com and tell me their shipping address.

  • List all customers in my Medusa store so I can see who is active.

  • Get the profile details for the customer named Jordan Lee.

  • Check the shipping address for the customer associated with the email support-test@domain.com.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Medusa once, then ask.

Just link your Medusa instance to Vinkius. Your credentials stay encrypted, and you can start asking questions in your preferred AI client immediately.

Connect Medusa to your AI

FAQ

How this task behaves

  • 01

    Can the AI change a customer's shipping address?

    No. The AI can only read existing customer data through the available tools.

  • 02

    Can the AI delete customer accounts?

    No. There are no tools provided to delete or modify customer records.

  • 03

    How does the AI find a specific person?

    It uses the list and get tools to match the names or emails you provide in your prompt.

  • 04

    Do I need to stay in the Medusa admin dashboard?

    No. Once connected, you do everything through your AI client.

  • 05

    Can the AI see my order history too?

    No. This specific task is limited to customer profiles and addresses.

  • More questions about Medusa? See everything the Medusa Connector can do

Connect MedusaJS to Claude, Cursor, ChatGPT & more