Connect an AI assistant
Paste one URL into Claude, ChatGPT or Cursor to let it search the catalog, see everything you own, and hand you download links.
On this page (7)
You can connect an AI assistant to your threejsassets.com account so it can search the catalog, answer questions about everything you own — asset packs, character sets, the icons library — and point you at your downloads, without you leaving the chat. Setup is one URL:
https://mcp.threejsassets.com/connectThat URL is an address, not a secret. It grants nothing on its own: you approve every connection yourself, in your browser, and you can revoke it at any time. There is no key to copy and nothing to paste into a config file.
Connecting an assistant is included with any purchase. If you have not bought a pack or lifetime access yet, Account → Connections says so instead of offering the connection.
Connect Claude#
- In Claude, open Settings → Connectors → Add custom connector and paste the URL above.
- Claude opens a browser tab on threejsassets.com. Sign in if you are not already — you get the usual magic-link email, and clicking it brings you back.
- You land on a Connect Claude? screen. It names the app that is asking and shows the account email, so you can check you are connecting the right account.
- Tick the permissions you are happy with, then select Allow.
- The tab returns you to Claude and the connector shows as connected. Ask it something — "which threejsassets packs do I own?" is a good first question.
Claude Code and Cursor support custom connectors too, and ChatGPT can add one from its own connector settings. Wherever the option lives, you paste the same URL and the browser half of the flow is identical. Support for custom connectors varies between clients and versions, so if you cannot find the setting, check your assistant's own documentation.
Choose what it can do#
The consent screen is a checklist, and each box is a separate decision:
| Permission | What it allows |
|---|---|
| See your name and email address | The account this connection belongs to, and nothing else. |
| Browse the public catalog | Anything on the site anyone can already see, of any product type. |
| See which products you own | Your purchases and order dates. No payment details. |
| Create download links for products you own | Links into your existing downloads. It can never reach something you have not bought. |
| Search the threejsassets documentation | The same public articles you are reading now. |
Create download links starts unticked — you opt in rather than out. Anything you leave unticked genuinely stays off: if the assistant tries to use it later, the answer is a refusal explaining which permission is missing, not a quiet workaround.
You can connect again later with a different set of ticks. Every fresh connection asks again, starting from the default ticks rather than the narrower set you chose last time.
What the assistant can actually do#
A connection gives the assistant thirteen tools. Which ones it can reach depends entirely on the boxes you ticked:
| Permission | Tools it unlocks | What you get |
|---|---|---|
| Browse the public catalog | search_catalog, get_product_details, get_pack_details, get_asset_details, search_icons, get_icon | Search everything published — packs, character sets, the icons library — and pull up the details of one product, pack, asset or icon. |
| See which products you own | list_purchased_packs, list_purchased_products | Your packs on their own, or everything you own grouped by kind, with the dates you bought them. |
| Create download links for products you own | get_download_link, get_asset_download_link, get_product_download_link | A link to a pack's bundle, a single asset's GLB, or any product you own — a character set's source bundle, the icons library ZIP. |
| Search the threejsassets documentation | search_docs | The articles you are reading now, quoted back with a link. |
| See your name and email address | get_me | Which account the connection belongs to, and whether it holds lifetime access. |
search_catalog takes an optional kind, so "which character sets do you sell?" narrows to those rather than sweeping in packs and assets. list_purchased_packs is unchanged and still answers "which packs do I own?"; list_purchased_products is the wider version that also covers character sets and the icons library.
Those download tools return links, not files. The assistant gives you an address that opens the right place on Account → Downloads; the download itself still happens signed in, in your browser, under your license. Ask for a pack you do not own and it says so plainly and points you at the pack page.
Single assets work the same way. Ask for one asset — by the slug you see in a search result — and the assistant links you straight to it: a free asset links directly to its download, and a premium asset opens your Downloads page filtered to exactly that asset, download button in view. Premium assets belong to their pack, so you need that pack or lifetime access; without it the assistant names the pack the asset comes from and links its page, because assets are not sold separately. Both kinds of link need the Create download links permission.
Downloading files directly. Alongside the browser link, the assistant also gets a temporary direct link it can fetch by itself — so it can pull a pack's zip or an asset's GLB straight into your project without you clicking anything. That direct link is deliberately short-lived (a few minutes) and works only for the one file, the one account, and the one connection it was made for; if it expires, the assistant just asks for a fresh one. It is not a way around your licence: every fetch re-checks, at that moment, that your account still owns the file, so revoking the connection or refunding an order stops it immediately.
Icons in the chat#
Icons are the one thing an assistant hands you directly rather than as a link, because an icon is a few lines of SVG.
search_icons finds icons by keyword or category and answers with metadata only: name, category, tags, the icon's page, and a 256px preview image anyone can view. Ask for a specific one with get_icon and you get the actual <path> markup plus a ready-to-paste SVG document — but only when your account is entitled to that icon and this connection has Create download links ticked. Miss either and the assistant gets the preview URL and a short reason saying which one is missing, so it can tell you whether to unlock the library or reconnect with the box ticked.
That is the same rule everywhere else on the site: the artwork itself is a download, so it rides the download permission.
Manage and revoke connections#
Open Account → Connections and look under AI assistants. Each connected app is listed with its name, the permissions you granted in the same words the consent screen used, when you connected it, when it was last used, and a roll-up of which tools it has called and how often.
Select Revoke to cut a connection off. The confirmation names the app so you cannot revoke the wrong one. After that the app must ask for permission again the next time you use it — a revoked connection stays listed, struck through with its revocation date, so "did I already revoke this?" is always answerable.
AI connections and API keys are different things#
They solve different problems and are never interchangeable:
- An AI connection is for a chat assistant. You approve it in the browser, no credential is ever shown to you, and you manage it under AI assistants.
- An API key (
tja_live_…) is for your own scripts and CI. You copy it once and store it yourself. See API quickstart.
A TJA_ license key is a third thing again — it proves your license, and it is not a credential for either of the above. See API authentication and keys.
Next steps#
- Products and icons over the API — the same inventory from a script.
- API quickstart — automate downloads from a script instead.
- How downloads and license keys work — what you get, and where.
- License terms — what you may ship with the assets you own.
Ask us directly — we answer support mail ourselves.