Connect Hudu
Hudu is an IT documentation platform for passwords, assets, knowledge base articles, and procedures. Connecting Hudu to StackJack gives your AI assistant tools for companies, assets and asset layouts,…
Written By Christopher Scaminaci
Last updated 9 days ago
Hudu is an IT documentation platform for passwords, assets, knowledge base articles, and procedures. Connecting Hudu to StackJack gives your AI assistant tools for companies, assets and asset layouts, passwords, knowledge base, procedures, networks, websites and expirations, labels, photos, and admin data through StackJack's MCP endpoint. See the generated Hudu tool reference for the current inventory, input schemas, plan tiers, and safety notes. (MCP, the Model Context Protocol, is the open standard that lets AI assistants like Claude, ChatGPT, and Copilot call your MSP tools securely.)
Hudu is one of the simplest connectors to set up: it needs just your Hudu instance URL and a single API key.
Before you begin
- You need the Owner, co-owner, or Administrator role in StackJack to configure connectors.
- You need admin or super-admin access to Hudu (the Admin > API Keys area is admin-only).
- Know your Hudu instance URL, for example
https://yourcompany.huducloud.com(or your self-hosted address). - Connecting a connector automatically activates it on the Free plan. You can upgrade to a paid plan at any time from the Connectors page — current pricing is shown in the portal.
Tip: The same steps below are always available in-app — open Connectors, find the Hudu card, and click How To Connect.
Step 1: Create an API key in Hudu
- In Hudu, go to Admin > API Keys.
- Click + New API Key and give it a descriptive name (for example,
StackJack Integration). - Configure the key's creation-time restrictions to match what you want your AI assistant to do. Use least privilege:
- restrict the key to specific companies;
- control whether the key can access passwords;
- control whether the key can perform destructive DELETE operations;
- control whether the key can export data;
- restrict it to Magic Dash endpoints if that is the only surface required;
- configure IP whitelisting.
- Copy the generated API key promptly and store it securely — Hudu obfuscates it after 5 minutes. These controls are selected when the key is created; create a replacement key if you later need a different scope.
⚠ If you turn off password access on the key, StackJack's Hudu password tools will fail with permission errors. If you enable IP whitelisting, StackJack's servers must be on the allow list. StackJack does not publish its outbound addresses: open a support ticket to get the current addresses for your region before you enable the restriction, and ask again after a region move, because they change. If validation fails with an authorization error and you use IP whitelisting, that restriction is the first thing to check.
Step 2: Add the credentials to StackJack
In the StackJack portal, go to Connectors and click Configure on the Hudu card.
Fill in the two fields:
Click Save.

What happens when you save
- Your API key is stored encrypted in Azure Key Vault. It is never stored in StackJack's database, and the portal never re-displays a saved key.
- StackJack immediately test-calls Hudu to validate the credentials. If validation fails or times out, your credentials are still saved and you'll see a warning — validation retries automatically in the background.
- A Free plan subscription for Hudu is activated automatically if you don't already have one.
- If validation keeps failing (three consecutive definitive failures), StackJack auto-disables the connection, emails the tenant owner, and shows Re-enable and Update Credentials buttons on the card.
What StackJack can access in Hudu
Access is governed entirely by the restrictions you set on the API key. With an unrestricted key, the tool families cover:
To narrow this, create the key with tighter restrictions in Hudu (Step 1.3) and/or limit which Hudu tools each team member and MCP client can use from StackJack's Permissions and MCP Setup pages.
Images in knowledge-base articles
To put a picture inside an article, have your AI assistant use the Create Public Photo tool (hudu_create_public_photo, Pro plans). It takes the image as base64 or as a public https link, accepts image files only, and returns Hudu's /public_photo/... address, which goes in the article's HTML as <img src="...">. The Create Upload tool stores a file as an attachment instead: Hudu shows it as a /file/... link on the record and it does not appear inline in an article.
Hudu's article create and update API lists no draft field, so StackJack cannot set an article's draft status (it can read it, and filter articles on it).
Photos, uploads and exports
Hudu has two photo features, and StackJack covers both. Public photos are the images embedded in article and asset-note HTML (see above). The photos module is Hudu's own photo library: your AI assistant can list photos, read one, add one (the Create Photo tool, Pro plans), change its caption, folder, pinned or archived state, or the record it belongs to, and delete it. A new photo needs a caption and an image file, and can be attached to a company, an asset or an article, or placed in a photo folder. Like the other file tools, it takes the image as base64, as a public https link, or as a StackJack upload reference (see Sending a file to a tool), and it accepts image files only.
To get a file back out of Hudu, the Get Photo, Get Public Photo, Get Upload and Get Export tools take a download option. With it on, StackJack fetches the file from Hudu, keeps it briefly, and gives your assistant a read-only link that expires in about 30 minutes; a file over 100 MB is refused. Without it, the tools return the record's details as before. Two things to know about exports: Hudu keeps an export file for 24 hours after it is created, and an export made with passwords included carries those passwords, so treat its download link like the passwords themselves.
Labels and pinned articles
Labels are Hudu's tags. A label type defines the tag (its name and colour, whether every company or only chosen companies may use it, and which kinds of record it applies to), and a label applies one label type to one record, such as an asset, a password, a website or an article. Your AI assistant can create, list, read, change and delete both; a record can carry a given label type only once. Reading is available on every plan, and changing needs Pro.
Your assistant can also pin a knowledge base article to the top of the article list and unpin it again. Hudu will not pin an archived article, so unarchive it first.
Details worth knowing when writing records
Hudu is strict about a few values, and StackJack passes them through exactly as Hudu documents them:
- A website needs a company and a name, and the name is the site's name or address (there is no separate URL field).
- A flag type's colour is one of Hudu's named colours (Red, Blue, Green, Yellow, Purple, Orange, the Light variants, White or Grey), not a hex code.
- A password folder needs a security setting: all users, or specific groups (named by group ID).
- An expiration can be archived or restored through the API; Hudu documents no other change.
- Reordering Magic Dash items needs the company and at least two items, with positions starting at 1.
- A custom field on an asset is set by the field's label in lowercase with underscores; dates are written
YYYY/MM/DD.
Pagination and rate limits
Hudu returns list results in 1-based pages, with 25 results by default. StackJack list tools accept page and pageSize and cap a request at 1,000 results. Hudu publishes a limit of 300 requests per minute; StackJack applies the same per-tenant pacing, so a burst is slowed rather than sent all at once. Other applications using the same Hudu instance draw on the same allowance, so pacing cannot keep you under it on its own. Pacing is not a guarantee: retries are bounded, so a wide enough read can still come back throttled or time out. Narrow the read, honour any retry delay the vendor sends, and check whether a write landed before repeating it — see Retrying a failed or timed-out write.
Troubleshooting
Disconnecting
Click Disconnect on the Hudu card to delete the stored credentials from Key Vault. Any AI tools using the connector stop working immediately.
⚠ Disconnecting does not cancel a paid plan — billing continues until you cancel it separately. The plan controls only appear while the connector is connected, so end the plan before disconnecting. On a paid connector that button reads Manage on Billing and opens this connector's removal dialog on the Billing page; a legacy website subscription still reads Cancel Plan. If you've already disconnected, save your credentials again to bring the plan controls back, then end the plan.
Hudu tools
hudu_ · 176 tools · Free 72 · Pro 104
Companies
Assets
Asset Layouts
Knowledge Base
Passwords
Procedures
Networking
Websites & Expirations
Rack Storage
Flags
Labels
Photos
Lists
Integrations
Users & Groups
Admin & System
Analytics
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team