Troubleshoot the ezeep MCP server connection ezeep Support Support

Open navigation

Troubleshoot the ezeep MCP server connection

Most problems fall into three groups: the client never connects, the client connects but some calls fail, or a call succeeds and the answer is wrong. Work down the section that matches what you are seeing.

The client never connects

ProblemMost likely
No ezeep tools appear at allThe endpoint was not accepted, and the failure is usually silent. Check the URL character by character, since a missing slash or a stray character in the host produces nothing rather than an error. Confirm the address starts with https, and confirm your client supports remote HTTP servers rather than local ones only. Where a configuration file is involved, a syntax error anywhere in that file can leave you with no tools and no message. Restart the client after any change.
Sign-in opens but never finishesThe browser window returns you to the client and nothing happens, or the loop repeats. Close the window, allow pop-ups and third-party cookies for the sign-in page, then start the connection again from the client rather than retrying in the browser.
Call fails with an authorization errorThe sign-in never completed, or stored credentials have expired. Disconnect the server in your client and reconnect it, which forces a fresh sign-in. Reusing the existing connection will not re-authorize it.
It worked an hour and now it does notAccess tokens are short-lived. Reconnecting the server in your client resolves this.

The client connects but some calls fail

ProblemMost likely
A management call gets refusedAsk the assistant which ezeep account you are connected as. The response includes that account's roles, which tells you whether you are signed in as the identity you expected. Reconnect with the right account if not.
A connector call returns a bare errorThat connector identifier does not exist. Ask for the connector list and use an identifier from it.
Job status reports an invalid job identifierEither the identifier was mistyped, or it came from something other than a print submission. Job identifiers are returned when a job is submitted, and they are the only thing that tool accepts.

A call succeeds but the answer looks wrong

ProblemMost likely
A printer has no propertiesA printer identifier that does not exist returns an empty result rather than an error, so an assistant can report this as "no properties" when the truth is "no such printer." Ask for the ezeep printer list, confirm the printer is on it, then ask again using the name exactly as it appears.
A list is shorter than you know it should beGroups and connectors paginate, and the assistant may have read only the first page. Ask for the total count and compare, or ask it to fetch the remaining pages.
You asked which file types are supported and got a wall of configuration.The underlying call returns the whole platform configuration with the extensions buried inside it. Ask for the file extensions specifically.
A user says they never received their invitationA successful invite call creates the invitation without guaranteeing delivery, and an invitation whose email failed still displays as open with a future expiry date. Check its delivery state in the admin portal before sending another.
A job was accepted but nothing printedThe job is queued against its connector. Ask which ezeep connectors are offline first, because a job sent to a printer behind an offline connector is accepted and then waits. Check the job status after that.

When the problem is not the MCP server

A healthy connection that lists printers correctly means the MCP server is doing its job, and a print problem at that point is an ordinary ezeep print problem. Check the connector, the printer and the job in the admin portal the way you would for any other job. Nothing about MCP changes how jobs are handled once they are submitted.

ezeep MCP server tools covers what each tool returns, which helps when an answer looks wrong rather than absent.

L
Laura is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.