Skip to main content

How to connect AI agents to 3Dsellers using MCP

Connect 3Dsellers to Claude, ChatGPT, Claude Code, Cursor or any MCP-compatible AI agent: what the AI can read and change, how to connect, and what to ask.

Written by Karolina Santiago

What is the 3Dsellers MCP server?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and data sources. The 3Dsellers MCP server gives AI agents secure access to your 3Dsellers account, so you can ask things like "show me my unshipped eBay orders" or "publish these products to my Etsy store" and get real results from your live data.

One connection covers your whole 3Dsellers company, including every connected marketplace account. If you have more than one seller account, you scope a request to a specific one with its seller ID (just ask the AI to "list my sellers" to see them).

What can the AI do with 3Dsellers?

Once connected, an AI agent can work across the areas below. Most tools read your data; the ones marked write can change it.

Products (read + write)

  • List and filter your products by SKU or segment, with variants included

  • Create a product with variants, pricing, inventory, images, dimensions, and identifiers (UPC, ASIN, EAN, and more), and optionally auto-generate its SKU from a SKU template

  • Fully replace a product, or partially update it (change just the title, price, inventory, or images without touching other fields)

  • Add or remove product tags

Publishing & listings (read + write)

  • Get product listings, the per-channel, per-seller view of a product. Filter by channel (eBay, Amazon, Etsy), seller, SKU, linked product, status (Active, Library, Ended), or segment, and follow a listing back to its catalog product

  • Publish products to a marketplace using the same add-to-channel flow as the app, to create new listings or revise existing ones

  • Add or remove listing tags

Orders (read + tag)

  • List and filter orders for a seller by status, channel (eBay, Amazon, Shopify...), SKU, or marketplace order ID

  • Add or remove order tags

Product categories (read + write)

  • List your categories, and create new ones

Listing & SKU templates (read + write)

  • View mapping templates and see how each one maps your product fields onto a channel

  • Bulk-apply channel field mappings (item specifics) across categories, with a dry run first

  • Look up the fields a channel category accepts and your saved custom attributes

  • List, create, and delete SKU templates (reusable formulas that build SKUs from product attributes, text, and random parts)

Sellers & policies (read only)

  • List your connected marketplace accounts, filter by channel, and get details for one

  • Read a seller's marketplace business policies (payment, shipping, return) for use when publishing

Segments (read only)

  • Get your saved segments (saved filter sets), and use a segment's ID to scope product or listing queries to it

CSV imports (read + write)

  • List import jobs and their status (pending, processing, done, error)

  • Get a specific import with its row-level errors, or search validation errors by SKU or item ID

  • Run a one-off CSV import into your Product Catalog or Listing Tool, with a dry run first that checks the column mapping against the file

  • Schedule recurring imports: create, pause, change, run now or delete scheduled imports that re-read a file from an https, SFTP or FTP link on a set frequency. They show up on your import pages next to the schedules you created in the app

Bulk actions (write)

  • Run large batch operations from the built-in action catalog, for example tag a whole segment, generate SKUs, or publish in bulk. These run in the background, and the AI can track progress and tell you when they finish

Step 1: Get your MCP token

You only need this token for the developer setups in Step 2 (Claude Code, and the JSON config for Cursor and similar tools). If you are connecting through claude.ai, Cowork, or Claude Desktop (Option A) or ChatGPT (Option D), you can skip this step and sign in instead.

1. Open the API/MCP page

Log in to your 3Dsellers account and open Settings > Profile > API / MCP, or go straight to app.3dsellers.com/api-mcp. The page opens on the Tokens tab.

2. Click Connect MCP

At the top of the Tokens tab are three buttons: Add to Claude, Get API token and Connect MCP. Click Connect MCP to open the connection dialog.

The Tokens tab of the 3Dsellers API/MCP page with the Add to Claude, Get API token and Connect MCP buttons

The dialog has everything in one place: Connect in Claude, the five steps for the Claude app with the server URL and Copy URL, and For developers further down.

The 3Dsellers MCP dialog with Connect in Claude, the Add to Claude app steps and the server URL

3. Generate and copy your token

Under For developers, generate a token and copy it right away. A token is shown only once, when it is created. Generating another one keeps the existing tokens working, so revoke the ones you no longer use from Issued tokens on the same page.

Keep your token private. Anyone with it can read and change your 3Dsellers data. Do not commit it to code or share it in public channels. If it is ever exposed, revoke it under Issued tokens and generate a new one.

Step 2: Connect to your AI tool

Pick the path that matches how you use AI. Option A is the easiest and needs no token; Options B and C are for developer tools and use the token from Step 1.

Want the steps for one assistant only, with its own FAQ? See the per-assistant guides:

Option A - claude.ai, Cowork, or Claude Desktop (easiest, no token)

3Dsellers is now listed in Claude's connector directory, so you can add it in a couple of clicks. This path signs you in instead of using a token, so you can skip Step 1.

  • Open the 3Dsellers connector in Claude's directory and click Connect. (You can also get there from Settings or Customize > Connectors > Browse connectors and search for 3Dsellers.)

  • Sign in to your 3Dsellers account and approve access. There is no token to copy for this path.

  • Turn the connector on inside a chat or Project from the + > Connectors menu.

The listing is marked Community, which means it is built and maintained by 3Dsellers rather than by Anthropic. That is expected.

Prefer to add it manually? You can still use + > Add custom connector with the server URL https://api.3dsellers.com/mcp. The result is the same.

Option B - Claude Code (CLI)

Run this command in your terminal, with your token from Step 1 in place of YOUR_TOKEN_HERE:

claude mcp add --transport http 3dsellers https://api.3dsellers.com/mcp --header "Authorization: Bearer YOUR_TOKEN_HERE"

That registers the server with Claude Code. Next time you open a session, the tools are available automatically.

New to Claude Code? See the official setup guide: docs.anthropic.com/en/docs/claude-code/mcp

Option C - Cursor, VS Code, and other MCP clients (JSON config)

Open your client's MCP settings file and add this block, with your token from Step 1 in place of YOUR_TOKEN_HERE:

{  "mcpServers": {    "3dsellers": {      "type": "http",      "url": "https://api.3dsellers.com/mcp",      "headers": {        "Authorization": "Bearer YOUR_TOKEN_HERE"      }    }  }}

Save the file, restart your AI tool, and the 3Dsellers server will appear in its connected tools list.

Cursor config file:

  • All projects: ~/.cursor/mcp.json

  • One project: .cursor/mcp.json in the project root

Or open Cursor Settings > Tools & MCP and add the server there.

Claude Desktop config file (if you prefer editing the file to Option A):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Official guide: modelcontextprotocol.io/quickstart/user

Other clients. Any tool that supports remote MCP servers over HTTP can connect with the same URL and bearer token, including VS Code (through GitHub Copilot's MCP support), with support in other assistants expanding over time. Only the place you enter the server differs; the url and Authorization header stay the same. Check your client's MCP documentation for where its config lives.

Option D - ChatGPT (sign in, no token)

ChatGPT connects to the same 3Dsellers MCP server. In ChatGPT, add a new app, give it a name, paste the server URL https://api.3dsellers.com/mcp, and choose OAuth for sign-in. Then sign in with your 3Dsellers account and click Accept. In a chat, open the + menu and pick 3Dsellers.

ChatGPT's screens and the plans that include apps can differ, so if yours looks different, check OpenAI's help page for your plan.

Step 3: Ask the AI what it can do

Once connected, the fastest way to start is to ask the AI to describe its tools. Try one of these:

  • What 3Dsellers tools do you have access to?

  • What can you help me with in 3Dsellers?

  • List the available 3Dsellers MCP tools

The AI reads the tool manifest and explains each capability in plain English. From there you can start asking real questions about your store.

Example things to try

  • Summarize my orders from the last 24 hours, and list anything that hasn't shipped

  • Which of my listings have errors, and what do the errors say?

  • Is every channel still connected and syncing?

  • Show me unanswered Helpdesk tickets, and draft a reply to the oldest one. Don't send it.

  • Show me any CSV imports that failed this week, and why

  • Which 10 SKUs sold the most this month, and how many of each do I have left?

  • Which automations are on, and what does each one do?

  • Tag every unshipped order over $100 as "priority"

  • Find products with no UPC and tag them "check-identifiers"

  • Create a new product with SKU ABC-123, price $19.99, quantity 50

  • Get products in my "Summer Sale" segment

  • Publish products 101, 102, and 103 to my eBay store

Tip: start with "Show me first, don't change anything yet." You see exactly what the AI plans to touch before it changes anything, and you can review every tool approval before it runs.

Step-by-step guides

Once you are connected, these guides walk through the most common tasks, with example prompts and more advanced multi-step requests:

Building your own integration, or need webhooks? See Working with the 3Dsellers developer API.

Where are the "with Claude" buttons in 3Dsellers?

3Dsellers has with Claude buttons in the parts of the app that take the most setup. Each button opens Claude with a ready-made request for that page, and Claude then does the work in your 3Dsellers account through the 3Dsellers MCP server. You find them here:

  • Listings > Create Listing and Product Catalog > New Product: Create with Claude, the last item in the menu.

  • CSV Import pages (Listings and Product Catalog): Import with Claude.

  • Automations (Listings, Product Catalog, Orders and Ads): Build with Claude, next to Suggest Automations.

  • Mapping Templates: Map with Claude.

  • Orders: Ask Claude.

Create with Claude option at the bottom of the Create Listing menu in 3Dsellers Listings

"Create with Claude" is not the same as the Create with AI options in the same menu. Create with AI runs inside 3Dsellers. Create with Claude opens Claude, which works through your 3Dsellers MCP connection.

What happens if Claude is not connected yet?

If your 3Dsellers account is not connected to Claude, a "with Claude" button opens the Connect Claude to 3Dsellers dialog. It shows the three steps and a short video. Click Continue to Claude to open the 3Dsellers connector in Claude, then follow Option A above.

Connect Claude to 3Dsellers dialog with three steps and the Continue to Claude button

Until you connect, 3Dsellers also shows a few Claude tips: a Work faster with Claude banner on the Dashboard, an Easier with Claude band on the CSV Import pages, and a short "3Dsellers in Claude" video window. Close the Dashboard banner with the X to hide it for 30 days. In the video window, Maybe later hides it for 14 days and Don't show again hides it for good. The tips disappear once your company has any active MCP or API connection, while the "with Claude" buttons always stay.

Frequently asked questions

Can the AI make changes to my store?

Yes, and more than it used to. The AI can create and update products and categories, manage SKU templates, tag products, listings, and orders, apply channel mapping templates, publish products to a marketplace (which creates or revises live listings), queue bulk actions across many records at once, and run one-off or scheduled CSV imports. It only ever acts on your own account's data, but it can delete some of it: it can remove products from your catalog and delete automations, segments, mapping and offer rules, templates, auto messages and exports. Reading is available across every area; the marketplace-facing writes (publishing, bulk actions and Update Live Listings imports) change live listings, so give those prompts the same care you would the app's own bulk tools.

Which AI tools are compatible?

Any client that supports MCP. You can connect through claude.ai, Cowork, and Claude Desktop as a custom connector (sign in, no token), ChatGPT as an app with the same server URL (sign in), or through developer tools like Claude Code, Cursor, and VS Code (via GitHub Copilot) using your token. The connection details are the same everywhere; only where you enter them differs.

Do I need the token or can I just sign in?

Both work. Connecting inside claude.ai, Cowork, or Claude Desktop (Step 2, Option A) uses sign-in, so there is no token to manage. Developer tools that read a config file (Claude Code, Cursor, VS Code) use the bearer token from Step 1.

Is my data secure?

Yes. Requests go directly to the 3Dsellers API over HTTPS, and the AI tool only sees the data returned by the specific tool it calls. Keep any token you generate private. A token is shown only once, when it is created, and generating another one keeps the existing tokens working, so revoke the ones you no longer use under Issued tokens on the API/MCP page (Settings > Profile > API / MCP).

I have several marketplace accounts. Does one connection cover them all?

Yes. One connection works for your whole 3Dsellers company. Ask the AI to "list my sellers" to see each connected account and its seller ID, then include a seller ID in a request to scope it to one account.

Where do I find the full API documentation?

Full endpoint documentation is available at api.3dsellers.com/docs. For an overview aimed at developers, see Working with the 3Dsellers developer API.

Something is not working. Who do I contact?

First check the basics: if you used a token, that you pasted the whole thing after "Bearer " with no extra spaces; that the URL is exactly https://api.3dsellers.com/mcp; and that you restarted your AI tool (or reopened the connector) after setting it up. If it still will not connect, use the "Need more MCP tools?" button in the integration dialog to reach the 3Dsellers team, or use your normal support channel.

Need more MCP tools?

The 3Dsellers MCP server is growing. If there is a resource or action you wish the AI could access, such as shipping management or feedback, you can request it directly from inside the app.

Go to Settings > Profile > API / MCP > Connect MCP and click "Need more MCP tools?". Your request goes straight to the 3Dsellers team and helps prioritize what gets built next.

Related Articles
Did this answer your question?